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Objectives 


Preface 


This manual describes the RSTS/E operating system and the use of the Digital 
Command Language (DCL) on RSTS/E systems. 


This manual describes commands for operations such as working with files, 
getting information about the system and its devices, printing files and running 
batch jobs, and developing programs. Note that this manual does not describe 
commands which require privileges for you to use them; see the RSTS/E System 
Manager’s Guide for descriptions of privileged DCL commands. 


Audience 


Although some familiarity with computers is helpful, you do not need to be an 
experienced computer user or programmer to use this manual. 


Document Structure 


The manual is divided into eight chapters and two appendixes: 


Chapter 1 


Chapter 2 
Chapter 3 
Chapter 4 
Chapter 5 


Chapter 6 
Chapter 7 


Chapter 8 
Appendix A 


Describes the basics of the RSTS/E system and how to use it. It in- 
cludes descriptions of the command environments, running a program, 
and using DECnet/E. (DECnet/E allows you to communicate with other 
computers. ) 


Describes how to use commands interactively and introduces how to 
use command procedures. 


Describes the RSTS/E commands used to create, display, edit, copy, and 
compare files. 


Describes how to use DCL in day-to-day RSTS/E operations, such as 
displaying system status and changing your password. 


Describes how to display and set your terminal characteristics, and 
how to enable and disable terminal logging. 


Describes the devices available for your use on a RSTS/E system. 


Describes the commands in the RSTS/E Print/Batch Services (PBS) 
facility, used to submit files for print or batch processing. 


Describes the commands available for you to develop and run programs. 


Lists error messages that RSTS/E displays when you enter a command 
that RSTS/E cannot execute. 


Appendix B 


Contains information about the BASIC-PLUS, RSX, and RT11 com- 
mand environments. It also contains information about RSTS/E file 
specification. 


The manual also contains a glossary of RSTS/E and DCL terms. 


Related Documents 


To learn about editing text with the EDT editor, see the Introduction to the EDT 
Editor and the EDT Editor Manual. 


See the RSTS/E Guide to Writing Command Procedures for more information on 
command procedures and their use. 


For complete details on how to define and control SORT and MERGE operations, 
see the PDP-11 SORT /MERGE User’s Guide. 


To get started with BASIC-PLUS-2 programming, read the Introduction to BASIC 


Manual. 


See the RSTS/E Documentation Directory for a description of the other manuals 
in the RSTS/E documentation set. 


Conventions 


This manual uses the following symbols and conventions: 


[J 


<> 


Ctri/X 


<RET> 


this typeface 


color 


Square brackets show the optional parts of a command in format 
statements. For example: 


DIRECTORY [file-specf,...]] 


The square brackets in this example indicate that you can include a file 
specification ([file-spec]), or more than one ([,...]), if you choose. 


Square brackets also indicate an optional part of the command. For 
example: 


/[NOJDELETE 


This means you can type either /DELETE or /NODELETE, depending 
on the form of the qualifier you select. 


Do not confuse the square brackets in command formats with the 
square brackets in Project-Programmer numbers (PPNs), as in [52,20]. 
See Chapter 1 for a description. 


Angle brackets surrounding text indicate a place holder for what the 
system inserts when an error message occurs. 


The control key, which you use in combination with another key. For 
example, enter Ctrl/U by holding down the Ctrl key and pressing the 
keyboard key labeled "U." RSTS/E displays, or echoes, Ctrl/U at your 
terminal, as “U. 

The key labeled Return on your terminal. You press the Return key to 
complete lines and commands that the system will process. 
Information in this typeface indicates an example of computer/user 
dialogue. 


In examples, red characters indicate information that you enter into 
the computer. Black characters represent data produced by the com- 
puter. 


(I) A vertical bar indicates a choice. For example: 


/LOWERCASE=[INPUT | OUTPUT] 
means you can enter /LOWERCASE=INPUT OR /LOWERCASE=OUTPOUT. 


bold A term in bold lettering indicates that the term is defined in the 
glossary at the end of this guide. The bold typeface appears only at the 
initial usage of the term. 


Summary of Technical Changes for RSTS/E V10.0 


RSTS/E V10.0 is a major release of the RSTS/E PDP-11 operating system. This 
manual describes the following new features: 


e Extended logicals 
e¢ Host initiated (Outbound) LAT 
¢ Command line editing and recall 


e Operator/Message Services (OMS) 


xi 


Chapter 1 
Getting Started with RSTS/E 


This chapter introduces you to RSTS/E and contains information to help you 
become familiar with using the system. 


This chapter explains how to: 


Use your account 

Edit and recall your commands 
Maintain files 

Run a program 


Use DECnet/E 


1.1 Using Your Account 


Tabet 


In order for you to use the computer, your system manager must assign you 
an account number and password. The account number identifies you to the 
system. The password is a precaution to keep unauthorized users from accessing 
the system. 


When you log in, the system displays a message at your terminal to confirm that 
you are logged in to your account. The system may also display informational 
messages. 


Privileges 


After you log in, you have access to all the RSTS/E facilities that your account 
allows. Your system manager decides what privileges to give your account. 


Like most users of your system, you will probably have sufficient privileges to 
create, modify, copy, and delete your own files, as well as to change your own 
password. Other users of your system may be granted additional privileges, 
allowing them to perform operations such as: 


Creating and deleting accounts 

Adding commands to the system 

Controlling the number of users on the system 
Saving user files in case of accidental damage 
Shutting down the system 

Reading and modifying other users’ files 
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This manual describes only those commands, command qualifiers or switches, 
and functions that can be used by most system users, that is, users who do not 
have privilege to affect accounts other than their own, or to affect the system 
itself. See the RSTS/E System Manager’s Guide for detailed descriptions of 
commands, qualifiers, and functions requiring additional privileges. 


1.1.2 Your Project-Programmer Number 


Account numbers on RSTS/E are called project-programmer numbers, or 
PPNs. Your PPN corresponds to your account and identifies you as a system user. 


A PPN consists of two numbers enclosed in square brackets and separated by a 
comma, for example, [52,20]. The numbers are as follows: 


e A project number (the number 52 in [52,20]), which corresponds to a group of 
users. For example, all employees in a particular work group may be assigned 
the same project number. 


e A programmer number (the number 20 in [52,20]), which is unique for each 
user in the group. 


The brackets around the PPN show that the two numbers are used together. 
Do not type the brackets when you log in, although you will need to use the 
brackets in many operations dealing with files. Also, do not confuse brackets 
around a PPN with brackets used to indicate optional parts of a command. (See 
"Conventions' in the Preface.) 


If you have more than one account on the system, you must use different PPNs 
and passwords to log in to your different accounts. 


1.1.3 Your Password 


Your password protects your account from unauthorized use. Passwords on 
RSTS/E systems can consist of 6 to 14 alphanumeric characters. (The sys- 
tem manager may restrict some users’ passwords to a maximum length of 6 
characters, while other users may use up to 14 characters.) 


Your system manager may assign you a password or let you choose your own. 

The method of assigning a password depends on the policy at your site. However, 
most users are granted sufficient privilege to change their own passwords at will. 
(Frequent password changes help to protect the system from unauthorized users.) 


To minimize the chances that unauthorized users can discover your password, 
Digital recommends the following guidelines: 


¢ Do not use names or words that could be readily associated with any user (for 
example, WRITER, GUEST, or your first name). 


¢ Choose a password that contains both letters and digits. 


e Change your password at least once a month. 


See Chapter 4 for details on how to use the SET PASSWORD command to change 
your password. 
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1.1.4 Using the Terminal (CTRL, DELETE, RETURN Keys) 


You use a terminal to communicate with the system. Terminals can be grouped 
into two main categories: hardcopy and video. A hardcopy terminal, such as an 
LA120, prints the characters you type and data from the system onto line printer 
paper. A video terminal, such as a VT100 or VT220, displays characters on a 
Cathode Ray Tube (CRT) screen. 


Most of the keys on a terminal match the keys on a typewriter keyboard. 
However, several keys on your terminal’s keyboard have special functions. 
Three of the most commonly used function keys are labeled Ctrl, Delete (also 
known as Rubout), and Return. 


For a complete list of the Control Keys which have special meaning to RSTS/E, 
see Table 1-1. 


Ctrl The key labeled Ctrl is called the control key. You always use the control key 
in combination with another key. For example, you can use Ctrl/U to delete all 
the characters on a command line, up to the cursor, if you have not yet pressed 
the Return key. Enter Ctrl/U by holding down the control key and then pressing 
the "U" key on the keyboard. RSTS/E will clear all characters on the line up to 
the cursor. On hardcopy terminals, RSTS/E will display, or "echo", this at your 
terminal as “U. For example: 


$ EDIT/EDT RACER.PDQ <Ctr1/U> 

On your terminal, this looks like: 

$ EDIT/EDT RACER.PDQ “*U 

The line is now deleted. Press the Return key for the DCL prompt: 


<RET> 
$ 


Delete The Delete key has the same function on a hardcopy terminal and on 
a video terminal, but the effects look different. On some hardcopy terminals 
the key labeled Rubout performs the delete function. On the VT200-series and 
VT300-series terminals the Delete key is labeled (<XJ). Use the Delete key to 
erase one letter at a time, or hold the key down to erase words and lines. For 
example, suppose you misspell a command and use the Delete key twice: 


$ COPIE <DEL><DEL> 
On a video terminal, the resulting line reads: 
$ COP 


By contrast, a hardcopy terminal displays deleted characters between backslashes 
(\), because a hardcopy terminal is not designed to "erase" characters. For 
example: 


$ COPIE\EI\ 
Return The Return key allows you to: 


e End commands - - - When you enter the name of a command, pressing the 
RETURN key tells the system to execute the command. For example: 


DIRECTORY <RET> 
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e End lines - - - When you enter text in a file, the Return key ends each line 
and begins a new one. For example: 


Fach year about 500 <RET> 
runners enter Littleton’s <RET> 


annual road race. 


<RET> 


e Respond to a prompt - - - Sometimes pressing the Return key causes the 
system or a program to assume a response, or "default." For example, the 
following system prompt allows you to enter a line width, but lets you know 
that, if you press Return without entering a number, the system assumes a 
width of 50 characters per line: 


Width of line <50>? <RET> 


Table 1-1 is a list of special keys, including control keys, that you can use 
at various levels of the system. Some keys have special line editing or recall 
purposes. Command Line Editing and Command Recall is discussed in section 


1.4. 


Table 1-1: Special Function Keys on RSTS/E 


Key 
CtrVA or F14 


Ctrl/B or Up Arrow 


CtrV/C 


Ctrl/D or Left Arrow 


Ctrl/F or Right Arrow 


Ctrl/H, Backspace, or F12 


Ctrl/E 


Ctrl/I or TAB 
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Function 


Toggles from overstrike mode to insert mode, or vice 
versa, while editing a command line. Effective only until 
a delimiter is entered, then the mode reverts back to the 
terminal setting. 


Recalls the previous command typed by the user at the 
current command level. When Ctrl/B or Up Arrow is entered, 
the current line, if any, is erased and the next previous 
command from the recall buffer is put in its place. The 
cursor is positioned at the end of the recalled command, 
regardless of the position of the cursor previous to the recall. 


Halts execution of the current command or program and 
usually returns control to the job keyboard monitor. (In 
some programs, Ctrl/C may return you to the program’s 
command level.) Ctrl/C echoes on the terminal as “C. You 
can lose data with Ctrl/C because it causes an immediate 


halt. 


Moves the cursor left, or backward, one character position in 
the command line. If the cursor is already at the beginning 
of the command line, the key is ignored. 


Moves the cursor to the right or forward one character 
position in the command line. If the cursor is already at the 
end of the command line, the key is ignored. 


Moves the cursor to the beginning of the command line. If 
the cursor is already at the beginning of the command line, 
the key is ignored. 


Moves the cursor to the end of the command line. If the 
cursor is already at the end of the command line, the key is 
ignored. 


Moves the cursor to the next tab stop on the terminal line. 
By default, tab stops are eight spaces apart (see the SET 
TERMINAL/TAB command ). 


(continued on next page) 


Table 1-1 (Cont.): Special Function Keys on RSTS/E 


Key 


Ctrl/J, Line Feed, OR F13 


CTRL/L or Form Feed 


CtrYN or Down Arrow 


CtrlV/O 


Ctrl/Q 


Ctrl/R 
CtrlV/S 


Ctrl/T 


Function 


On terminals that do not support line editing, it ends the 
current line. Line Feed moves the cursor to the next line but 
does not return the cursor to the left side of the screen. On 
terminals that do support line editing, deletes the word to 
the left of the cursor. Deleting a word will do the following: 


1. Delete any consecutive spaces and tabs immediately to 
the left of the cursor. 


2. Delete any consecutive alphanumeric characters [A-Z, 
a-z, 0-9], immediately to the left of the cursor. 


3. If no characters were deleted in step 2, then delete a 
single, non-alphanumeric, character. 


Sends a typed line to the system for processing and skips four 
lines on a video terminal. Form Feed and Ctrl/L advance the 
paper to the top of the next page on hardcopy terminals (see 
the SET TERMINAL/FORM_ FEED command). 


Performs a function similar to CTRL/B or Up Arrow except it 
moves forward in the recall list, obtaining the next command 
entered. Requesting a forward recall, when at the most 
recent entered command of the recall buffer, results in 
erasing the current command line on the screen, and no line 
is recalled. 


Stops and restarts terminal output while a program is 
running. Ctrl/O does not affect program execution; however, 
the system discards all terminal output the program produces 
between the time you stop output and restart it again. Ctrl/O 
echoes as "“O" on the terminal. 


Resumes terminal output suspended by Ctrl/S while a 
program is running. You can only use Ctrl/Q if the TTSYNC 
(or STALL) characteristic is set for the terminal. (See 
Chapter 5 for more information on terminal characteristics.) 


Redisplays all characters of the current command line. 


Suspends terminal output while a program is running. 
You can use Ctr//S only if the DCL TTSYNC (or STALL) 
characteristic is set for the terminal. When you use CtrlI/S, 
the system saves all terminal output that the program 
produces instead of discarding it (as it does when you use 
Ctrl/O). (See Chapter 5 for more information on terminal 
characteristics. ) 


Displays a one-line status report for your job. The report 
includes your job number, keyboard number, job state, and 
other information. See Chapter 4 for more information. 


(continued on next page) 
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Table 1-1 (Cont.): 
Key 


Ctrl/U 


Ctrl/X 


CtrV/Z, 


Delete or Rubout 


Escape or Altmode or 
Ctrl/[ 


Hold Screen 


No Scroll 


Return 


Special Function Keys on RSTS/E 


Function 


Erases all characters from the beginning of the line to the 
cursor. The remaining characters are shifted to the beginning 
of the command line. Ctrl/U erases characters from the 
screen on terminals which support line editing. On multiline 
commands, deletes only the portion of the command from the 
cursor to the left margin. Ctrl/U behaves the same, whether 
command line editing is enabled or not. If the terminal is 
set to HARDCOPY, “U will be displayed and the remaining 
portion of the command will be displayed on the next line, 
similar to earlier versions of RSTS/E. 


Deletes all type-ahead including the current terminal line. 
Ctrl/X echoes as “X and moves the cursor to the next line. 


Is an end-of-file (EOF) marker. Ctrl/Z can also be used to end 
a DCL command and return to the DCL prompt. Echoes as 
"AZ" on the terminal. 


Erases the character to the left of the cursor. Any charac- 
ters to the right of the cursor are shifted to the left. On 


hardcopy terminals, erased characters are displayed between 
backslashes. 


Sends a typed line to the system for processing or starts an 
escape sequence if the terminal is set /ESCAPE_SEQUENCE. 
Escape, Altmode, and Ctrl/[ Echo on your terminal as a dollar 
sign ($). 

Performs the same function as Ctrl/S and Ctrl/Q on VT200 
and VT300-family terminals. The TTSYNC (or STALL) 


characteristic must be set for the terminal. 


Performs the same function as Ctrl/S and Ctrl/Q on VT100, 
VT101, VT125, and other VT100-series terminals. The DCL 
TTSYNC (or STALL) characteristic must be set for the 
terminal. 


Sends a typed line to the system for processing. Pressing 
Return moves the cursor to the beginning of the next line. 


NOTE 


A common mistake is to press the No Scroll key (on VT100s), Hold 
Screen key (on VT200 or VT300 series), or Ctrl/S (on VT52s) to stop 
output to the terminal, and then forget to press No Scroll, Hold Screen, 
or Ctrl/Q to resume output. (Nothing is displayed at the terminal when 
you press No Scroll, Hold Screen, or Ctrl/S.) In either case, the system 
does not display another DCL prompt when you press Return. You 
must press No Scroll or Hold Screen again, or Ctrl/Q, to resume output. 


1.1.5 Beginning a Terminal Session: HELLO or LOGIN 


You can log in to your account on the system as soon as you have a PPN and 
password. RSTS/E provides two commands for logging in to your account: 
HELLO and LOGIN. To get started, type HELLO (or LOGIN) and press Return: 


HELLO <RET> 
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The system signals that it is in operation by displaying a message similar to: 


RSTS/E V10.0-L 15-Jun-90 05:52 PM 


User: 
This message gives you the following information: 
e The name and version number of the computer’s software. 


° The current date and time. RSTS/E keeps track of the length of time you use 
the system and its resources, starting with the date and time of login. 


¢ The prompt for your account PPN. RSTS/E displays the User: prompt. 


Login also allows you to log in using a (system) logical name instead of a PPN. 
You can respond to LOGIN’s User: prompt with a system logical name (without 
a trailing colon). Most systems which use this feature will set up the logicals to 
match your name, or account type, (for example, Smith, Writers, or Manager). 


Enter your account PPN, (or system logical name) and password after the 
prompts as shown. Note that the system does not display your password as 
you type it. This prevents anyone who may be watching from discovering your 
password. 


User: 52,20 <RET> 
Password: <RET> 


You will generally be able to log in this way with no problems. However, it may 
help you to know the following constraints: 


° If you wait too long before answering the User: and Password: prompts (the 
limit is 30 seconds) or if your response to either prompt is incorrect, the 
system prints ?Invalid entry - try again, and reprints the User prompt. If 
you type in the wrong PPN, the system does not tell you until after you have 
typed your password. 


e After two invalid login attempts, RSTS/E waits 5 seconds before displaying 
the User prompt; this wait time increases with each successive invalid login 
attempt. 


e After five invalid login attempts, the system prints ??Access denied. If you 
are trying to use the system over a dialup line when this happens, the 
system disconnects the phone line. Verify your PPN and password before 
trying again. 


When you log in successfully, you may see two messages showing the date and 

time you last logged in to the system, both interactively and noninteractively. 
Noninteractive logins are batch jobs or network file transfers. These messages 
confirm that you now have access to RSTS/E. For example: 


Last interactive login on 14-Jun-90, 08:50 PM at KB48: 
Last noninteractive login on 05-Jun-90, 02:08 AM 


Your system manager may choose to display other messages of general system 
interest: 


15—~Jun-90 The system will be down Saturday, 16-Jun-90, 
from 8:00 AM to 1:00 PM for maintenance. 


$ 


RSTS/E is now at the command level, which means that it is ready to accept the 
commands you enter. The dollar sign ($) prompt indicates the DCL command 
environment, which is the default for RSTS/E. 
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You can also use the LOGIN command when you are already logged in to the 
system if you want to "reset" your current job to the state it was when you 
originally logged in. Use the LOGIN command to log in your current job under a 
different account. This allows you to switch between accounts without having to 
first issue the LOGOUT command. If you do not have sufficient privilege, then 
you will be prompted for the password of the account you want to log into. Typing 
LOGIN while you are logged in causes RSTS/E to execute the Login procedure 
again, as if you had logged out and then logged back in. 


1.1.6 The System Command Environment 


The default keyboard monitor on your system is the command environment that 
is present when you log in. DCL is the default keyboard monitor for RSTS/E 
systems. The dollar sign ($) prompt means that RSTS/E is ready for you to enter 
DCL commands. 


1.1.7 Other Command Environments 


From DCL, you can switch to one of three other command environments, all of 
which have different prompts, as shown: 


Ready The BASIC-PLUS environment 
> The RSX environment 
The RT11 environment 


Some commands — such as RUN to run a computer program — are common to all 
environments. Other commands are available in only one environment, although 
the actions you perform are similar throughout the command environments. 

For example, you use the DELETE command in the DCL environment to delete 
files you have created; you use the UNSAVE command in the BASIC-PLUS 
environment to perform the same function. 


RSTS/E uses DCL as its default command environment because DCL commands 
are used on other Digital systems, including VAX/VMS. So if you change from a 
RSTS/E to a VAX/VMS system, or back again, you will be able to use many of the 
same commands. 


You may want to switch from the DCL command environment, depending on 
your work needs or your particular preference. For example, the BASIC-PLUS 
environment is useful if you do a great deal of programming in the BASIC- 
PLUS language. By the same token, the RSX and RT11 environments emulate 
the commands available on Digital’s RSX and RT-11 operating systems for the 
PDP-11 computer; if you have worked with either of these systems, you may feel 
more ‘at home" in one of these environments. Appendix B provides more detailed 
information about switching between the command environments. In addition, it 
lists some of the commonly used commands in the BASIC-PLUS, RSX, and RT11 
environments. 
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1.2 Echo on Read 


Echo on read is the processing and echoing of characters typed on a terminal 
only when a program or command environment is waiting for input. In versions 
of RSTS/E prior to V10.0, characters were processed and echoed as soon as you 
typed them, even if no program or command environment was waiting for imput. 
In some instances, these typeahead characters would be processed incorrectly. For 
example, if you begin typing your password before LOGIN issued its Password: 
prompt, the characters you typed were echoed, then when the password: prompt 
was issued, your password would show up before the prompt making the entry 
incorrect. 


Echo on read has a very different “look and feel” than previous versions of 
RSTS/E. Most noticeable is the lack of any visual cues when you type ahead 
(since typeahead characters are no longer echoed until a read occurs). You may 
conclude that your terminal or the system is not functioning properly; if so, type 
Ctrl/T to see that your terminal and the system are still operating. 


1.2.1 Using Login Command Files 


At login, the RSTS/E system attempts to execute the systemwide command file 
LOGIN.COM located in account [0,1] on the system disk. This file contains 
commands defined by the system manager that are executed for all users. In 
addition, the systemwide login command file normally contains a command that 
invokes a private LOGIN.COM file located in your directory on the system disk. 
If your system manager allows the use of private LOGIN.COM files, the system 
automatically executes these commands every time you log in. This feature lets 
you tailor the system for your everyday use. 


For example, if you enter the same sequence of commands every time you log 

in, place these commands in a command file (also called a command procedure) 
named LOGIN.COM. You can also define synonyms for often-used DCL commands 
in your LOGIN.COM file, making them easier to type and remember. The 
LOGIN.COM file could also contain commands to assign logical names, run 
programs, execute other command procedures, or display message files. For 


example: 

S TYPE SNEWS.TXT ! Display system messages 

S @TERM.COM ! Execute a command procedure 

S RUN DB1: [2,214] COOKIE.EXE ! Run a program 

S ASSIGN DR3:[4,214] WORK ACCT ! Assign a logical name 

$ TODO == "@REMIND" ! Define a command to execute a procedure 
S == "SHOW SYSTEM" ! Abbreviate a command 

S WH-O == "SHOW USERS" ! Nickname a command 


Use the at sign (@) command to execute and test your LOGIN.COM file. For 
detailed information on creating and executing various types of command 
procedures, including LOGIN.COM files, see the RSTS/E Guide to Writing 
Command Procedures. Figure 1-1 shows the difference between the user-defined 
and the system-defined login command files. 
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Figure 1-1: Executing System and User Login Files 


RSTS/E V9.0 15-Jun-85 12:35 PM 


Users 29214 


Passwords | 


Last logged in on 14-Jun-85 9:35 AM at KB3?: 


$ 


¥:CO+1] LOGIN.COM 


The system LOGIN.COM runs 
until the end-of-file, 


TYPE SNOTICE. TXT 


when control is passed 
to [2,214] LOGIN.COM 


5 
+ 
t 
$ 
+ 
+ 


SENDLOGIN: 


DBi:(2+sf141] LOGIN.COM 


[2,214] LOGIN.COM runs ' 
until the end-of-file ASSIGN DRS:C2+;214] WORK: 
$ 


RUN DBi:C2+214] COOKIE.EXE 


When [2,214] LOGIN.COM 
completes, control is 
returned to user at 
terminal 


In Figure 1-1, the file specification for the system-defined Login command file 
is SY:[0,1JLOGIN.COM. The file specification for the user-defined Login file is 
DB1:[2,214]LOGIN.COM. When user [2,214] logs in, the system-defined Login 
file executes first. After the system-defined Login file completes, the command 
interpreter locates and executes the user-defined login file on the default disk and 
directory for user [2,214]. 


1.2.2 Getting Information About Commands: HELP 


You can use the help facility to learn about the commands that are available on 
RSTS/E. Each time you use HELP, RSTS/E displays the information you request 
and then displays the DCL prompt. 


To use HELP, type: 


S$ HELP <RET> 
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The system displays the list of DCL Commands as well as various general help 
topics on which you can get information: 


You can obtain online information about any DCL command or qualifier, 


as well as many other general topics. 


topic, refer to the appropriate RSTS manual or guide. 


For more complete details about a 


The RSTS/E System User’s Guide contains descriptions of the DCL commands 
and programming operations. 


and qualifiers that you use in file, 


system, 


The RSTS/E System Manager’s Guide contains descriptions of the DCL 
commands and qualifiers used in system management operations. 


See the RSTS/E Quick Reference Guide for the syntax of all 
DCL commands and qualifiers on RSTS/E. 


For instructions on how to use this HELP facility, 


type HELP HELP from 


DCL, or type HELP in response to the HELP Topic? prompt. 
Additional help is available on: 

@ Accounts Advanced ALLOCATE APPEND 
ASSIGN ATTACH BACKUP BASIC BROADCAST 
BYE cc CCL CLOSE COBOL 
Command Recall COPY CREATE Dates DCL 
DEALLOCATE DEASSIGN DEFINE DELETE DETACH 
DIBOL DIFFERENCES DIRECTORY DISMOUNT DUMP 

EDIT Entries EOD EXIT Expressions 
Files FORCE Forms FORTRAN Functions 
GOSUB GOTO HANGUP HELP IF 
INITIALIZE INQUIRE INSTALL Keys Labels 
Line Editing LINK LOAD LOGIN LOGOUT 
MACRO MATL MERGE MOUNT ON 

OPEN Operators Passwords PRINT Privileges 
Programs Queues Quotas READ RECALL 
REMOVE RENAME REPLY REQUEST RESTORE 
RETURN RTL RSX RUN Runtime Systems 
Servers SET SHOW SORT START 

STOP SUBMIT Symbols Times TYPE 
UNLOAD WAIT WRITE 


The help display on your system may be different from what is shown here 
because the system manager can change the help information. 


The display lists topics on which help is available. For example, if you want to 
read about the LOGIN command, you type: 


S HELP LOGIN <RET> 


RSTS/E displays information about the LOGIN command and lists its restrictions 
and qualifiers. The display on your terminal reads: 


S HELP LOGIN 
LOGIN 
The LOGIN command is used to: 


o Create a new job at a terminal you specify. You can use this 
feature in your system startup procedure, to log in various users 
automatically. You must have WACNT or GACNT privilege to do this. 


o Log in your current job under a different account. This allows you 
to switch between accounts without having to first issue the LOGOUT 
command. If you do not have sufficient privilege, then you will be 
prompted for the password of the account you want to log into. 


o Reset your current job to its initial logged-in state (the state 


your job was in after logging in). This is useful for resetting 
logical assignments, DCL symbols, prompts, etc. to their initial 
state. This requires no privilege. 
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Format: 
LOGIN [account] 


If you do not include an account <emphasis>(parameter\bold), then your 
own <line> account PPN is assumed. 


Privileges required: 


DEVICE to create a new job at a restricted terminal. 

GACNT or WACNT to log in a new job under a different account. 
GACNT or WACNT to log in a different account without being 
prompted for that account’s password. 


Command Qualifiers Defaults 
/ [NO] OVERRIDE [=NOLOGINS] /NOOVERRIDE 
/TERMINAL=KBn[: ] 

Prompts 

Password: (if logging into different account and no WACNT or 


GACNT privilege) 


For more information, see the RSTS/E System User’s Guide and 
and the RSTS/E System Manager’s Guide. 


The “Advanced topic gives more detailed information about RSTS/E on a wide 
variety of subtopics. 


Advanced 


The HELP topic ADVANCED is generally for reference by RSTS/E 
programmers. You can find more complete information about the 
subtopics below in the RSTS/E Programming Manual and the RSTS/E 
System Directives Manual. 


Additional help is available on: 


ASCII chart Disks FIP codes Floppy SPEC% 
Magtapes PEEK Pseudokeyboard STATUS word 
SYS calls Terminals 


RSTS/E help messages are available in a "hierarchy." This means that the 
help you request is available in levels of increasing detail. You can type HELP 
ADVANCED and a subtopic, such as Disks, for information about the disks on 
RSTS/E: 


Each topic may have a subtopic, or a subsubtopic which you can include in the 
command line: 


1.2.3 Ending a Terminal Session: LOGOUT or BYE 


RSTS/E provides two commands for ending, or logging out of, your terminal 
session when you are finished using the system: LOGOUT and BYE. (Use 
whichever of these two commands you find most convenient; their effect is 
identical.) 7 


You can include one of two qualifiers when using the LOGOUT command: /BRIEF 
or /FULL. 


If you simply type LOGOUT (or BYE), the /FULL qualifier is the default: 


3 ee & £8 £° 3° ok 2° FR Fy 
S LOGOU & SEs 
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RSTS/E displays information about the status of your account at the time of 
logout: 


Saved all disk files on SY: 1568 blocks in use 

Job 13 User 52,20 logged off KB2 at 15-Jun-90 02:36 PM 
System RSTS V10.0-L 

Run time was 3 minutes, 2.4 seconds 

Elapsed time was 21 minutes 

Good afternoon 


The logout information tells you: 


e The status of your permanent files (Saved all disk files). RSTS/E also shows 
the use of your file storage space (1568 blocks in use). 


¢ Your job number (13), PPN (52,20), terminal number (KB2), the date (15-Jun- 
90) and time of logout (02:36 PM). 


e The name and version of the computer’s software (RSTS/E V10.0-L). 
e The time you spent at the terminal (run time and elapsed time). 


e Any logout messages (Good afternoon). 


Note the difference between run time (3 minutes and 2.4 seconds) and elapsed 
time (21 minutes). Run time is the amount of the Central Processing Unit’s 
(CPU) time you used. The commands you type require the use of the system’s 
CPU. Elapsed time shows how long you were logged in to the system. Although 
you were logged in for 21 minutes, you used the computer’s CPU for only a 
fraction of that time. If you include the /BRIEF qualifier after the LOGOUT 
command, RSTS/E ends your session at the terminal by displaying a one-line 
message. The BYE command has a corresponding qualifier, /F (for "fast"), which 
produces the same message as LOGOUT/BRIEF: 


S BYE/F <RET> 
Job 13 User 52,20 logged off KB2 at 15-Jun-90 02:36 PM 


1.3. Using DCL Command Qualifiers 


In the DCL environment, you use commands by typing a command name and 
pressing the RETURN key. You can also use qualifiers, which modify the effects 
of a command, by typing a slash (/) followed by a word the computer recognizes 
as a qualifier. For example, the LOGOUT command has two possible qualifiers: 
/BRIEF and /FULL. 


You type a qualifier after the command name but before pressing the RETURN 
key. If you do not use qualifiers, DCL makes assumptions known as defaults. 


For example, if you use the LOGOUT command, the /FULL qualifier is the 
default. You could type the /BRIEF qualifier instead, which modifies the effect of 
LOGOUT by displaying a one-line message instead of the full Logout display. 


Chapter 2 describes the use of qualifiers in more detail. In addition, the 
command descriptions in this manual list the qualifiers and defaults available for 
each command. 
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1.4 Editing and Recalling Commands 


This section describes command line editing and command line recall. These 
features significantly improve productivity by reducing the amount of keystrokes 
required to enter commands or correct typing errors. Because these features are 
implemented in the RSTS/E monitor, they are available at the DCL command 
level, within other keyboard monitors, and at the application program level. 


1.4.1. Command Line Editing 


Prior to RSTS/E V10.0, the only two line editing functions were: 


e The Delete or Rubout key to delete the previously typed character (to the left 
of the cursor) 


e Ctrl/U to delete the entire line 


This made it difficult to correct errors discovered near the beginning of a com- 
mand; you could either delete all characters back to the character to be corrected, 
or delete the line and re-enter it. There was no way to move the cursor within 
the line to make corrections. 


Command line editing makes it easier by adding several line functions that allow 
you to: 


¢ Move the cursor left or nght one character 

¢ Move the cursor to beginning or end of the line 
¢ Delete the previous word 

° Delete to the beginning of the line 

e Insert a new character at the cursor position 


e Overstrike (replace) an existing character at the cursor position 


These functions reduce the amount of typing required to correct errors or, when 
coupled with command recall, modify and re-execute already entered commands. 


1.4.2 Command Recall 


Command recall allows you to recall your most recently entered commands 

or program input lines. Command recall extends line editing additionally by 
allowing you to recall and change commands or program lines after they have 
been entered and executed. This saves time in re-entering the same command 
(such as editing the same file multiple times) or correcting a command that did 
not execute as expected. 


RSTS/E provides command recall for the following three separate command 
levels: 


¢ DCL commands 
¢ Commands entered in other keyboard monitors 


e Program input 
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Each command level is limited in size, therefore only a certain number of 
commands can be stored and maintained. As commands are entered, the oldest 
command in the buffer is deleted to make room for the new command. Unlike 
recalling commands on VMS, RSTS/E is not limited to only 20 commands. 
Instead, RSTS/E maintains as many commands as will fit in the buffer. The 
actual number of commands saved depends on the size of the buffer and the 
length of each command entered. 


DCL commands are stored in their own command level. The DCL level can be 
thought of as the highest command level, with the keyboard monitor level and 
program level following it. Commands stored in the DCL level are maintained 
until you log out, until they are replaced with newer commands as space 

is reclaimed, or until you specifically erase them with the RECALL/ERASE 
command. You can use the DCL RECALL/ALL command to list all of the 
commands available for recall in the DCL level, or to recall a specific command 
either by index number or text. See Section 1.4.3 for more information on the 
RECALL command. 


If you switch from DCL to another keyboard monitor, either with the SET 
JOB/KEYBOARD_MONITOR command or the SWITCH system command (CCL), 
you advance to the second command level - the keyboard monitor level. All 
commands entered at this level are stored and maintained separately from 
your DCL commands. Once you return to the DCL command level, all of the 
commands entered at the keyboard monitor level are erased and the DCL level 
is reactivated. This feature is especially useful for users who must occasionally 
switch to another keyboard monitor, such as BASIC-PLUS, to perform a task 
not accessible from DCL, for example, compiling a BASIC-PLUS program. The 
separate keyboard monitor level prevents non-DCL commands from being stored 
in the DCL level. 


A third command recall level is provided for program input. Whenever a program 
initially prompts for input from the terminal, the monitor sets up the third level. 
Lines entered at the program level are automatically saved and may be recalled, 
just like at the DCL level, without any special coding on the part of the program. 
Program lines will continue to be stored across program chains and Concise 
Command Languages (CCL) until you return to DCL or another keyboard 
monitor. At that time, the commands stored for the program are erased and the 
DCL or other keyboard monitor’s level is reactivated. 


Use the Up Arrow and Down Arrow terminal keys to move backward or forward 
in the current recall buffer (Ctrl/B and Ctrl/N can also be used, for terminals that 
do not have arrow keys). 


You can also use the DCL RECALL command to manage commands at the DCL 
command level. Use the RECALL command to: 


e Display your saved commands 
e Erase your saved commands 
e Recall a saved command by index number 


¢ Recall a saved command by text 


See the next section on the RECALL command for more information. 
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1.4.3 RECALL Command 


Format 


The RECALL command is used to: 

e¢ List all of the commands available for recall 

e Erase all of the commands in the current level 
e Recall a command by its index number 


e Recall a specific command by its leading text 


RECALL [integer /leading-substring] 


Command Qualifiers 
/ALL 
/ERASE 


Command Parameters 


[integer] 

Specifies the number of the DCL command you wish to recall. The default is 

1, indicating the most recently entered command. Command 2 is the next most 
recently entered command. The RECALL command itself is never assigned a 
number, since it is not saved in the command recall buffer. Use the RECALL/ALL 
command to list all available commands and their associated numbers. Command 
numbers can range from 1 to 65535. Thus any command entered at the DCL 
prompt may be recalled. If the number of stored commands is less than the 
number specified, the earliest available command is recalled. An error is returned 
if an integer not in the range 1 to 65535 is specified. When a command is 
recalled, it is not automatically executed. It is displayed on the screen with the 
cursor positioned at the end of the line. 


[leading-substring] 

You can also recall commands based on a leading substring of the command you 
wish to recall. The term leading substring refers to the first several characters in 
a command string. The substring can be as short as a single character. If the 
substring is not unique, RECALL recalls the most recently issued command line 
that matches the substring. For example, suppose you issue a SHOW SERVER 
command and later issue a SHOW TIME command. If you then type RECALL 
S, the SHOW TIME command is recalled. You must type RECALL SHOW §&, to 
recall the SHOW SERVER command. 


When searching for a command to match, leading spaces and tabs in the com- 
mand are ignored. All alphabetic characters are considered case insensitive for 
comparison purposes. 


An error is returned if the leading substring does not match any command stored 
in the current command level. 


When a command is recalled, it is not automatically executed. It is displayed on 
the screen with the cursor positioned at the end of the line. 
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Command Qualifiers 


/ALL 

Displays all commands currently available for recall, along with their command 
numbers. Remember that the RECALL command itself is never stored in the 
recall buffer. 


If /ALL is specified immediately after the RECALL command, an error will be 
returned if the integer or leading substring parameter is also specified. 


If /ALL is specified after the parameter, it is assumed that /ALL is part of the 
leading substring to recall. For example, if you enter a COPY/ALLOCATIONe=... 
command, and later issue the command RECALL COPY/ALL, the COPY com- 
mand will be recalled because there is a match on the characters COPY/ALL. 


/ERASE 

Erases the contents of recall buffer. All commands stored by the monitor for each 
level (DCL, other keyboard monitors, and programs) will no longer be available 
for recall. If /ERASE is specified immediately after the RECALL command, an 
error will be returned if the integer or leading substring parameter is specified. 
If /ERASE is specified after the parameter, it is assumed that /ERASE is part of 
the leading substring of the text to recall. For example, if you issue the command 
RECALL 1/ERASE, it will result in an error unless you previously entered a 
command which began with "1/ERASE". /ERASE is ignored if /ALL is specified. 
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1.4.4 Command Line Editing and Recall Keys 


All command line editing and recall keys are identical to those defined on VMS, 
with one exception. This exception is that RSTS/E defines the Ctrl/N key to recall 
the next (more recent) command in the recall buffer. VMS has no such control 
key defined. Ctrl/N has the same effect as the Down Arrow key. RSTS/E provides 
the Ctrl/N key to complement the Ctrl/B (recall previous command) key, so that 
you can move backward and forward in the recall list while the terminal is open 
in Escape Sequence mode (mode 256). 


Listed below are the special command line editing and recall keys. The online 
help topic Keys and the RSTS/E Quick Reference Guide also contain information 
on the use of these keys. Table 1-1 lists all keys which have special meaning to 
RSTS/E, in full detail. 


Left Arrow or Ctrl/D moves the cursor left, or backward, one character. 
Right Arrow or Ctrl/F moves the cursor right, or forward, one character. 
Ctrl /H, (BACKSPACE), or F12 moves the cursor to the beginning of the line. 
Ctrl /E moves the cursor to the end of the command line. 

Cirl/A or F14 toggles between overstrike mode and insert mode. 

Ctrl /J, (LINE FEED), or F13 deletes the word to the left of the cursor. 
Cirl/U erases all characters from the beginning of the line to the cursor. 
Cirl/R redisplays the command line without changing the cursor position. 
Up Arrow or Cirl/B recalls the previous command. 

Down Arrow or Cirl/N recalls the next command. 


1.4.5 Editing MultiLine Commands 


Multiline commands are commands or lines that extend beyond the terminal’s 
width and wrap onto one or more subsequent lines. The following rules apply 
when editing multiline commands on terminals which support line editing: 


e You can only move the cursor left or right or delete characters on the last line 
of a multiline command. You cannot move the cursor from the last line to a 
previous line of the command unless you first delete all of the characters on 
the last line (thereby making the previous line the last line). 


If the cursor is positioned at the first character of the last line and you press 
the Left arrow or Ctrl/D key to move the cursor left (to the last character of 
the previous line), then the key is ignored and the cursor does not move. You 
must first delete all of the characters on the last line, before you may position 
the cursor at the end of the previous line using the delete key. 


e Pressing Ctrl/U when the cursor is positioned on the last line of a multiline 
command line only erases characters to the beginning of that line, not to the 
beginning of the entire command. As always, any characters from the cursor 
to the end of that line are shifted left to the beginning of the line. 


e Similarly, pressing Backspace or Ctrl/H when the cursor is positioned on the 
last line of a multiline command only moves the cursor to the beginning of 
that line, not to the beginning of the first line. 


e If you press Line Feed or Ctrl/J to delete the word to the left of the cursor, 
and that word extends back to the previous line of a multiline command (the 
word is split across two lines), only those characters back to the beginning 
of the current line are deleted. The remainder of the word at the end of the 
previous line is not deleted. 
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¢ When you type Ctrl/R on multiline commands, the cursor is moved to the 
left hand margin, and spaces are displayed until the cursor lines up under 
the start of the command. For example, if you type a command which wraps 
onto a second line and press Ctrl/R, the display looks like this (vertical lines 
indicate terminal margins): 


| BEFORE “*R | | AFTER “*R | 
| | | | 
|PROMPT> Command wraps here| |PROMPT> Command wraps here| 
Jand continues on 2nd line. | | Command wraps here| 


| | [and continues on 2nd line. | 


Unlike VMS, RSTS/E does not save the current command’s prompt. It cannot 
redisplay the prompt with the command when Ctrl/R is pressed. 


Because of these limitations, you should try to avoid entering multiline commands 
whenever possible. In some cases you can use DCL command abbreviations or 
redefine frequently used “long” DCL command/qualifier strings to reduce the 
length of your command. You can also redefine your terminal width to 132 
columns (on terminals that support the extended width feature) to allow for 
longer commands on a single line. 


1.5 Maintaining Files 


Many of the DCL commands in this manual affect files. It is helpful to under- 


stand the relationship between accounts and directories when you work with 
files. 


1.5.1 Accounts, Directories, and Files 


When you begin a RSTS/E session, you log in to an account. Your PPN is an 
account number, which identifies you to the system. 


The system uses your account to keep track of the system resources you use, 
such as the amount of time you access the computer’s memory (run time) or are 
logged in (elapsed time), and the amount of storage space your files require. If 
you have more than one account on the system, RSTS/E sees each account as 
belonging to a separate user, who is identified by a PPN. 


A directory is a collection of files in your account that are kept in a specific 
location on a disk. An account may have several directories on different disks. 
Each directory stores information, such as the name and size of each file. 


You identify a file by specifying its location and its name. A file’s location consists 
of: 


e The node on the network — A node is a computer system with DECnet/E, 
which connects two or more systems together. See the section "Using 
DECnet' for more information. 


e The device — Files are usually kept on disks or magnetic tapes. Your files 
are located on a set of disks called the public structure, unless you specify 
otherwise. 


e The directory — A device can be divided into directories, in which you can 


store files. You specify your directory like you specify your account, by using 
your PPN. 
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A file’s name, chosen by the person who created the file, consists of: 
e ©The file name — One- to six-alphanumeric characters (MYFILE) 


e The file type — Zero- to three-alphanumeric characters, preceded by a period 
(.TXT) 


1.5.2 Putting Files into Your Directory 


You can put files into your directory either by moving them from another 
directory or account or by creating them. The following example creates a file 
with the CREATE command (see Chapter 3) to show the placement of a file in a 
directory. 


To use the CREATE command, type: 

$ CREATE <RET> 

The command prompts you for a file specification: 
File: 


You can assign the file almost any name you choose. For this example, name the 
file ROAD.MAP: 


File: ROAD .MAP <RET> 


Enter the text as follows, and press Ctrl/Z when you are finished. (Ctrl/Z is 
displayed on the terminal as “Z, but the characters “Z do not become part of the 
file.) If you make a mistake on a line before you press the RETURN key, you 
can press the DELETE key to correct it, or use any line editing keys described in 
Table 1-1. 


Although I have been a jogger for <RET> 
more than eight years, I did not <RET> 
enter any road races until 1989. <RET> 
<Ctrl1/Z> 

$ 


The newly created file named ROAD.MAP is now in your directory. 


1.5.3 Displaying Your Files 


If you are new to a RSTS/E system, you may or may not have files in your 
directory. Files exist in your directory only if someone put them there; it is 
possible that the system manager or another user gave you some files. If you 
created ROAD.MAP in the previous section, then information about the file 
appears in a directory listing. 


You can check for files in your directory with the command: 
$ DIRECTORY <RET> 


If you have no files in your directory, RSTS/E displays a message similar to: 


show that no files are found. 
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If there are files in your directory, the system displays information about each 
file. For example: 


Name .Typ Size Prot Name .Typ Size Prot Sx: (52, 20] 
TEMP16.TMP “| < 60> MAIL .MAI 30 < 60> 
BRANCH. BAC 15C <124> MAIL .SYS 14 < 60> 
FSS - BAC 11C <124> IOB » BAC 11C <124> 
HELP .COM i < 60> ROAD  .MAP z < 60> 


Total of 84 blocks in 8 files in SY: [52,20] 
Your directory provides the following information about each file in your account: 


Name.Typ The names and types of your files. 


Size The size of your files in numbers of blocks. (A block is 512 
characters.) 


Prot The protection code assigned to your files. This determines 
whether or not other users can read, write or execute the files. 


SY:[52,20] identifies your directory as being on the system disk (SY:) in your 
account ([52,20)). 


Certain operations (such as compiling and linking programs) cause RSTS/E to 
create a temporary file with a .TMP file type. Temporary files are scratch files 
that programs use for work space. The file named TEMP16.TMP in the preceding 
listing is a temporary file. 


Do not display or work with temporary files, because they often contain codes 
that can make your terminal work abnormally. Temporary files are mentioned 
only because they use disk space and are displayed in the directory listing; the 
system automatically deletes them when you Logout. 


The TYPE command displays the contents of a file. The following example shows 
the contents of the file ROAD.MAP: 


$ TYPE ROAD.MAP <RET> 

Although I have been a jogger for 
more than eight years, I did not 
enter any road races until 1989. 


1.5.4 File Specifications 


A file specification is the full name and location of a file. In its complete form, the 
file specification includes: 


e A node name on the DECnet/E network, if applicable 

e The device name or logical name (see Chapter 6 for descriptions) 
¢ The directory 

°¢ The file name 


e The file type 


The format of a complete file specification is: 
node::device:[directory ]filename.typ 


The delimiters (special characters) in a file specification are brackets, commas, 
and colons. Brackets ([]) surround a PPN. A comma (,) separates the two 
numbers in a PPN. Double colons (::) follow node names, while a single colon (:) 
follows the device name. 
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The delimiters (@), (%), (&) and (#) have been accepted since V9.0 to specify 
special system accounts, but their use is not supported. They are reserved DCL 
characters, and may have other meanings in the future. 


The special account delimiter (!) does not work in DCL. The exclamation point is 
used as the comment delimiter. 


Parentheses "()" are reserved DCL characters and cannot be used as a delimiter 
for a PPN in DCL. 


Protection codes in angle brackets (< >) cannot be used in DCL. The DCL syntax 
for protection codes is /PROTECTION:nn. 


A dollar sign ($) in place of a PPN indicates the directory [1,2], which is the 
system library. (The system library stores most of the system files and programs.) 
For example, the following command displays a system file named NOTICE.TXT: 


$ TYPE $NOTICE.TXT <RET> 
A file specification can be as simple as: 
ROAD .MAP 


In this case, RSTS/E assumes your own directory, the local node, and the system 
disk by default. See the section "Using DECnet" for an explanation of host node. 


An example of a file specification that does not assume any defaults is: 
GARP: :DRO: [52,20] ROAD .MAP 


The parts of the file specification are: 


GARP:: The node (system) on the network 

DRO: The device at node GARP:: on which the file is located 
[52,20] The directory on the disk at node GARP:: 

ROAD.MAP The file name and type 


1.5.5 File Names and Types 


When creating a file, you can assign it any name with up to six alphanumeric 
characters. You can also change the name of a file with the RENAME command 
(see Chapter 3). 


A file type consists of one to three alphanumeric characters that follow a file 
name. There is a period between the file name and file type. File types provide 
you with a shorthand way to identify a file’s contents. For example, the file 
STATUS.DOC has a file name of STATUS and a file type of .DOC. 


NOTE 


If you assign a file name of more than six characters or a file type of 
more than three characters, RSTS/E accepts your input then truncates 
the name to the first six characters and the type to the first three 
characters. For example, if you name a file LONGNAME.LIST, RSTS/E 
truncates it to LONGNA.LIS. 


You can assign any alphanumeric file name and type in a file specification, 
although it is a good idea to use a "mnemonic" name. This means that you 
should assign the file a name that reminds you of its contents. For example, 
TEST.DAT could be a data file (.DAT) that you create to test a program (TEST). If 
you have a file containing a BASIC-PLUS program to run your payroll, you might 
name it PAYROL.BAS. The file type .BAS indicates a BASIC-PLUS source file. (A 
“source’ file contains the program you typed in.) 
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An advantage of using a mnemonic file type is that RSTS/E recognizes several 
file types by default (for example, .DOC, .DAT, .RNO, .COM, and so on). If you 
assign a file one of these types, then you do not always have to type it explicitly. 
For example, if you are using the COBOL command to compile a program, you 
can type: 


$ COBOL PROGI1 <RET> 


RSTS/E assumes the resulting source file to be PROG1.CBL, because the file type 
.CBL is the default for a COBOL source file. 


Table 1—2 lists some common file types on RSTS/E. 


Table 1-2: RSTS/E File Types 


File Meaning 

.B25 BASIC-PLUS-2 source file 

-.BAC BASIC-PLUS compiled file 

.BAK Backup file created by several types of utility programs 
.BAS BASIC-PLUS source file 

.BCK BACKUP container set (or RMSBCK container set) 
.C PDP-11 C source file | 
.CBL COBOL source file 

.CMD Task Builder Command file 

.COM DCL command procedure 

.CRF Cross-reference listing file 

.CTL Batch control file 

.DAT Data file 

.DBL DIBOL source file 

.DIF DIFFERENCES or FILCOM output file 
.DIR File produced by the DIRECTORY command 
.DOC RUNOFF output file 

.EDT EDT initialization file 

.ERR System error file 

ESC Terminal setup file 

.FLB FMS-11 form library file 

FOR FORTRAN-IV source file 

.FTN FORTRAN-77 source file 

.H Header file in C language 

-HLP System program help text file 

.LIB Resident library file 

.LNK Input file used by the DCL LINK command 
.LOG Batch output log file 

.LST Listing file 

.MAC MACRO source file 

.MAI DECmail/RSTS mailbox file 


(continued on next page) 
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Table 1-2 (Cont.): RSTS/E File Types 


File Meaning 

.MAP Map file created by the LINK command or Task Builder 

-MLB MACRO library file used by the RSX-based MACRO assembler 

.MSG DECmail message file 

OBJ Object file, which is a compiled BASIC-PLUS-2, COBOL, DIBOL, 
FORTRAN, or MACRO program 

ODL Overlay Description Language input file used by the Task Builder 

-OLB Object module library file used by the Task Builder 

OMS Operator/Messages Services log file 

.PMD Postmortem Dump file 

.RNO RUNOFF input file 

.RTS Run-time system 

SAV Executable FORTRAN-IV or MACRO program produced by the LINK 
command or the RT11-based LINK program 

SIL Save Image Library (RSTS/E monitor or system program) 

SKL Skeleton file produced by the COBOL-81 compiler 

ML RT11 source MACRO library 

SRT SORT-11 file 

STB Symbol table file produced by the Task Builder 

SYS System file, usually for internal use 

TEC TECO source file 

TES TECO source program 

“TMP Temporary file created by a system program (deleted when you Logout or if 
the disk is rebuilt) 

TSK Executable BASIC-PLUS-2, COBOL, DIBOL, FORTRAN-77, or MACRO 
program produced by the LINK command or the Task Builder 

TXT ASCII text file 

.ULB Universal library file 

UNI Default file type for universal library files 


1.5.5.1 Protection Codes 


You determine who, if anyone, can have access to files you create by using 
protection codes. RSTS/E displays the protection codes of files between angle 
brackets (< >) in your directory listing. For example: 


Name .Typ Size Prot Name .Typ Size Prot Ssi2[52,;20] 
FINISH.COB 89 < 60> TENK  .RNO 130 < 60> 
START .BAS a < 60> ROAD .MAP 3 < 60> 


In the example, 60 is the default protection code that RSTS/E assigns. (On some 
systems, the system manager may have chosen a different default protection 
code.) If one of your files has a protection code of 60, only you (or a user with 
additional privileges) can read, edit, or delete it. A protection code remains fixed 
until you change it. See the section "Allowing Access to Files" in Chapter 3 for a 
list of available protection codes and a description of how to assign them. 
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1.5.5.2 Wildcards 


Wildcards let you refer to a group of files all at once by specifying a pattern 
of identification. You can use Wildcards to specify all files that have a common 
element in their names. 


For example, if you have the files TIMING.COB, TIMING.BAS, and TIMING.DAT 
is your directory, you can display information about them by typing a wildcard (in 
this case an asterisk) in place of the file type: 


$ DIRECTORY TIMING.* <RET> 
RSTS/E provides the following two wildcard characters: 


e Asterisk (*) — Use the * as a wildcard in specifying a PPN (for example, 
[*,20], [52,*], or [*,*]) or in specifying file names or types (for example, *.BAS, 
or MYFILE.*). You can also use Trailing Wildcards (for example, TEXT*.DAT 
matches all files that start with TEXT). 


¢ Question mark (?) — Use the ? as a wildcard to replace a single character 
in a file name or type. The question mark wildcard will display all file 
names containing the alphanumeric string, regardless of whether the single 
character is present. (For example, specifying PROG?.COB will display 
PROG.COB, as well as PROG1.COB, PROG3.COB, and PROGB.COB, if those 
files are present in the directory.) 


1.5.6 Exceeding Your Disk Quota 


On occasion, you may create more files than your RSTS/E disk quota allows. A 
disk quota is the amount of file storage space allocated to your account. 


RSTS/E enforces two disk quotas for your account: a "logged-in" quota which is 
enforced all the time you are using the system; and a "logged-out" quota, which is 
enforced at Logout time. You cannot Logout if you have exceeded your quota; you 
must first delete one or more files and then try again. 


For example, if you created a file named BIRDS.TXT to practice editing text, but 
you no longer need the file, you can delete it by typing: 


S$ DELETE BIRDS.TXT <RET> 


If you try to Logout and find you have exceeded your disk quota, the system 
displays a message similar to: 


$ LOGOUT <RET> 
Disk quota of 1000 exceeded by 128 blocks 
Some file(s) must be deleted before logging out 


$ 


In the previous example, RSTS/E will not let you Logout until you free at least 
128 blocks of storage space. The Size column in the DIRECTORY command (see 
Chapter 3) includes the blocks of storage space each file requires: 


$ DIRECTORY <RET> 


Name .Typ Size Prot Name .Typ Size Prot SY: [52,20] 
VANISH.COB 89 < 60> PATTYC.RNO 130 < 60> 

STRIDR.BAS 120 < 60> ROAD .MAP 280 < 60> 

FLAGS .DAT 159 < 60> TEST .MAC 350 < 60> 


Total of 1128 blocks in 6 files in SY: [52,20] 
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In general, it is a good idea to delete any files you do not need before attempting 
to Logout. This practice saves space on the system. If you need all your files, you 
can copy some of them onto magnetic tape to store them before deleting them 
from your directory. See Chapter 6 for information about copying files to magnetic 
tape. 


1.6 Running a Program 


You run most programs by typing RUN followed by the name of the program. A 
program that can be run is called an "executable" program. Chapter 8 describes 
the DCL commands for running, compiling, and linking programs on RSTS/E. 
For more information about each programming language, refer to the appropriate 
language manual and user’s guide. 


There are two types of executable programs: user programs and system 
programs. 


Some programs are referred to as user programs because they are created by a 
system user. For example, if you create a BASIC-PLUS program named BANKER 
that balances a checkbook, you can run the user program BANKER.BAC by 
typing: 

$ RUN BANKER.BAC <RET> 


Other programs are referred to as system programs, because they are installed 
as part of the system software. You can run system programs with one of the 
following: 


e ADCLcommand — For example, you run the system’s editor program (EDT) 
by typing EDIT and pressing the Return key. EDIT is the DCL command 
that runs the EDT program. 


e The RUN command — For example, you can switch to DCL from another 
keyboard monitor by typing: 
RUN $SWITCH <RET> 


Keyboard Monitor to switch to? DCL <RET> 
$ 


1.7 Using DECnet/E 


The DECnet facility links two or more Digital computer systems as a network. 
DECnet refers to both the hardware (machinery) and software (programs) 
involved in network operations. The DECnet software available on RSTS/E is 
called DECnet/E. 


If your system has DECnet/E, then your system is part of a network that allows 
you to perform file, system, and programming operations on another system. To 
find out if your system has DECnet/E, type the following command: 


$ SHOW NETWORK <RET> 
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You should get one of the following responses: 


e If the system displays network information (see the "Displaying Network 
Status" section), you can use DECnet/E on your system. 


e If DECnet/E is on your system but is not currently in operation, the system 
displays: 
$ SHOW NETWORK <RET> 
No information 


e If your system does not have DECnet/E, the system displays the error 
message: 


?Command not installed 


NOTE 
If your system does not have DECnet/E, go on to Chapter 2. 


You can use some of the commands in this manual over the network. The 
commands and their qualifiers that you can use in network operations are labeled 
with the symbol (N) in the command descriptions. 


DECnet/E also lets you log in to another computer system from your account. You 
can then use that system as though your terminal were connected to it directly. 
Use the SET HOST command (see the next section) to log in to another system, 
or node, on the network. 


To log in to another system on the network, you need to have an account and 
password for that system. In addition, the network between your system and 
the other system must be working. (You use the SHOW NETWORK command, 
described in the next section, to check for available nodes on the network.) 


You should know the following terms to become familiar with DECnet/E: 
Network The family of software modules, files, hardware components, and 
facilities that ties different Digital systems together. 


Node A computer system that is connected to other computers by a network. 
Node names are assigned by the system manager. There are three 
types of nodes: 


Host The node you access with the SET HOST command. 


Local The node you logged in to before using the network; your 
original system. 


Remote Any node in the network other than the local node. 


To summarize, the node of the network you first log in to is local, and the system 
you reach by the network is remote. You connect to another system by specifying 
the host and then logging in. However, if you want to communicate with a 
system on the network from your local node, you can use DCL commands over 
the network without logging in to the remote system. 


For a complete description of the capabilities that DECnet/E has to offer, see the 
Introduction to DECnet and the manuals in the DECnet/E documentation set. 
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1.7.1. Displaying Network Status: SHOW NETWORK 
The SHOW NETWORK command displays the systems you can connect to on the 
network. To use the SHOW NETWORK command, type: 
$ SHOW NETWORK <RET> 


If the network is in operation, RSTS/E displays the names of the different nodes 
your system can access. For example: 


Active Node Volatile Summary as of 11-JUN-90 14:31:11 
Executor Node = 1.135 (GARP) 


State = On 

Identification = GARP DECnet/E V4.1 
Active Links = 3 

Remote Node = 1.13 (SNOOPY) 

State = Reachable 

Circuit = DMC-1 

Remote Node = 1.20 (CLOUD9Q) 

State = Reachable 

Circuit = DMC-1 


For a complete description of the elements in the SHOW NETWORK display, see 
the DECnet/E System Manager’s Guide. 


1.7.2 Using the Network: SET HOST 
The SET HOST command lets you log in to another computer from the system 
you are currently logged in to. To use the SET HOST command, type: 
$ SET HOST <RET> 
RSTS/E prompts you for the node name with: 
Node: 


Enter the name of a node that is available on the network. For example, you 
connect to a node named SPEEDY by typing: 


Node: SPEEDY <RET> 


A faster method is to type SET HOST and follow it directly by a node name, then 
press RETURN. For example: 


$ SET HOST SPEEDY <RET> 


After the connection is made, the local node displays a message stating that the 
connection has been established. You must have an account on the remote node 
to log in. When the connection is established, you use the normal login dialogue 
for that system. When you successfully log in, you can use the remote node as if 
your terminal were connected to it directly. 


When you are finished, use the LOGOUT command to Logout of the remote node. 
After about five seconds, control returns to your local node. 
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There are two ways you can end your session at the remote node and return 
directly to the local node: 


° The first way, which Digital recommends for normal use, is to follow the host 
system’s normal Logout procedure. This deletes any temporary files you may 
be using. 


e The second way is to type CTRL/P, which prompts you for a network com- 
mand. For example: 


<CTRL/P> <RET> 
GARP::NET> EXIT <RET> 


For more information on using the network, see the DECnet/E Guide to User 
Utilities. 


1.7.3 SET HOST Behavior 


When you use SET HOST to connect to a remote system (using the NET utility), 
commands that you enter on your local system are sent to the remote system for 
processing. There are two character transfer modes available during a network 


connection: 
e¢ NORMAL mode 
¢ ODT mode 


These modes are selected by typing Ctrl/P (followed by RETURN if the current 
mode is NORMAL mode) and entering either ODT or NORMAL. In the default 
NORMAL mode, characters are echoed by the local system but the command 
is not sent to the remote system until a line delimiter is entered. ODT mode 
instructs the NET program to open the local terminal in binary mode, causing 
all characters to be echoed and sent to the remote system as they are typed. 
NORMAL mode is the preferred mode, as it reduces network overhead for each 
character typed. 


If LINE_EDITING and RECALL are enabled on the local system, these functions 
will also work when connected to a remote system, depending on the SET 
HOST transfer mode in effect. If the connection is operating in ODT mode, then 
the monitor will send all characters, including line editing and recall control 
characters and escape sequences, to the remote system. If LINE_EDITING and 
RECALL are enabled on the remote system (assuming that the remote system 

is running RSTS/E V10.0 or an operating system that supports these functions), 
those functions are performed by the remote system. Otherwise, the special 
characters are processed according to the key definitions defined on the remote 
system. 


If the SET HOST connection is operating in NORMAL mode, and the LINE_ 
EDITING and RECALL terminal attributes are enabled, the monitor on your 
local system handles all line editing and recall functions. The monitor treats all 
characters typed as data to the NET program. This means that regardless of 
your current level at the remote system (DCL, Keyboard Monitor, or Program), 
all commands that you enter are maintained in your local system’s program recall 
buffer. 


This behavior effectively gives you full command line editing and recall on any 
remote system that you connect to. However, some applications on the remote 
system may assign functions to keys defined in V10.0 as command line editing 
or recall function keys. For example, DECmail-11 defines the Right Arrow key 
as read next message and the Left Arrow key as read previous message. If you 
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attempt to run DECmail-11 on a remote system while in NORMAL transfer mode, 
and with LINE_EDITING enabled, the left and right arrow keys are intercepted 
and processed by your local system as line editing keys, effectively blocking their 
use by DECmail-11 on the remote system. Because there are more special editing 
keys defined than in previous versions of RSTS/E, you may encounter remote 
applications that do not process certain special keys correctly. 


There are two ways to overcome these problems. The easiest is to switch to ODT 
mode while connected to the remote system. Doing so opens your terminal in 
binary mode, thereby disabling command line editing and recall, and allowing 
any special line editing and recall keys to be passed to the remote system. 
Alternatively, you can use the SET TERMINAL command to disable command 
line editing (NOLINE_EDITING) or recall (NORECALL) or both prior to issuing 
the SET HOST command to connect to the remote system. 


Note that this does not represent an actual change in behavior compared to 
earlier RSTS/E versions. Prior to V10.0, arrow keys and other special function 
keys did not work properly across a network connection unless you switched to 
ODT transfer mode. Thus, the behavior is different, but consistent in relation to 
your local system. Since all commands are read by the NET program, they are 
stored and recalled as program-level commands. 
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Chapter 2 


Using RSTS/E Commands and Command 
Procedures 


This chapter shows how to use RSTS/E commands interactively. It also introduces 
special groups of commands, called command procedures or command files, that 
the system executes automatically for you. 


This chapter explains how to enter: 
e Commands 

e File specifications 

¢ Qualifiers 

¢ Character string data 

e Numeric values 

e Date and time values 


e Command procedures 


2.1 Understanding Command Formats 


The commands in this manual are grouped by related functions. (For example, 
Chapter 3 describes all commands that manipulate files.) Each command 
description includes: 


e A brief description of the command’s function 
e Syntax information (command parameters) 

e The command’s qualifiers and defaults, if any 
e The command’s prompts, if any 


¢ Detailed information about each command parameter and qualifier 
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The command format descriptions in this manual use the terms in Table 2-1. 


Table 2-1: Terms Used in Command Formats 


Term 


Format 
Qualifiers 


Command Qualifiers 
File Qualifiers 


Defaults 


Prompts 


Command Parameters 


file-spec 
input file-spec 


output file-spec 


Meaning 


The use of the elements in a command string. 


The elements that modify the effect of the command string in 
some way. 


Qualifiers that modify the command itself. 


Qualifiers that modify the treatment of a file included in the 
command string. 


The assumptions RSTS/E makes when you enter the com- 
mand string and do not use all the available parts of the 
format. 


The text that RSTS/E displays to request your input. 


The parts of a command string that specify what the com- 
mand is operating on. (For example, what file is affected by 
the command.) 


A file specification. 


The specification of a file to be used as input in the command 
string. 


The specification of a file to be used as output in the com- 
mand string. 


For example, the command format in Figure 2—1 lists the syntax elements for 
using the COPY command. (See Chapter 3 for the complete COPY command 


description.) 
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Figure 2-1: The COPY Command Format 


COPY 
Duplicating, Renaming, and Appending Files 


The commands described in this section let you duplicate, rename, and append the 
contents of files. 


COPY 


The COPY command duplicates one or more existing files, or concatenates two or 
more files. You can use this command for local and network file specifications. 


Format 
COPY _ input-file-spec[,...] | output-file-spec 


Command Qualifiers Defaults 


/Allocation = n 

/BEFORE = date 

IBLOCK.._.SIZE=n (BLOCK...SIZE=512 
CLUSTER...SIZE=n 

/CREATE 


ee (N) 


/[NO]JLOG 
/MODIFIED 
/[NOJOVERLAY /NOOVERLAY 
/POSITION[ = n] /POSITION = 0 
{= MIDDLE] 
{= INDEX] 
/PROTECTION=n 
/[NO]JQUERY /NOQUERY 
/[NO]JREPLACE 
/SINCE = date 


Prompts 


/LOG 


From: input-file-spec[,...] 
TO: output-file-spec 
OK to replace existing file file-spec ? 


Use COPY to: 
e Copy one file to another file 
e Merge more than one file into a single file 


e Copy a group of files to another group of files 


For example, if you have a file named SMITH.MAR and you want to make a copy 
of it as file JONES.JOE, you type: 


$ COPY SMITH.MAR JONES.JOE AED 
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Suppose you want to use COPY to copy all the files named JOKES and GAMES 
in your account to one file named PARTY.TYM on disk DB2:. 


In the following example, you specify that the files should not replace existing 
files. Therefore, you include the following information in the command line: 


e Acommand qualifier (/NOREPLACE) 
¢ Two input file-specs (JOKES.* and GAMES.*) 
e One output file-spec (DB2:PARTY.TYM) 


The dialogue at your terminal looks like: 


$ COPY/NOREPLACE <RET> 

From:  JOKES.*,GAMES.* <RET> 

Tos DB2:PARTY.TYM <RET> 

File JOKES.1 copied to DB2:[52,20]PARTY.TYM 
File JOKES.2 copied to DB2:[52,20]PARTY.TYM 
File GAMES.TXT copied to DB2:[52,20]PARTY.TYM 
$ 


Note that RSTS/E prompts you for your input. This is called "interactive" mode, 
meaning that you and the system are communicating directly with each other. 
RSTS/E can also operate in "batch" mode, meaning that the system is execut- 
ing commands in a command procedure. (A command procedure is a series of 
commands that RSTS/E processes automatically without requiring input from 
you.) 


RSTS/E displays its DCL dollar sign ($) prompt when the COPY operation is 
complete. 


2.1.1 Entering Commands 


The complete specification of a command, including the command name, command 
qualifiers, parameters, and file qualifiers (if any), is called a command string. 
Because you can continue a command on more than one line, RSTS/E uses the 
term command string to define the entire command that is passed to the system. 
By contrast, the term command line describes the part of a command string that 
you type on one line. 


The general format of a command string is: 
$ command-name[/qualifiers...] parameter[/qualifiers...][...] 
Each item in a command must follow these rules: 


e At least one blank or tab character must separate the command name 
from the first parameter; at least one blank must separate each additional 
parameter from the previous parameter. Note that you can use multiple 
blanks and tabs in all cases where a single blank is required. 


e Each qualifier must be preceded by a slash (/). You can enter any number of 
blanks or tabs before or after the slash. 


2.1.2 Continuing Commands on More than One Line 
The maximum number of characters you can enter on one line is 132. However, 


you can enter a command string on more than one line by using the continuation 
character, a hyphen (-), as the last element on a command line. 
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Command line continuation is especially useful when you enter a command and 
want to specify many qualifiers, or when you place a command in a command 
procedure and want to make the procedure more readable. For example: 


S PRINT MYFILE - <RET> 
/AFTER=17:00 - <RET> 
/COPIES=20 - <RET> 
/NAME=GUIDO <RET> 


There is no restriction on the number of continued lines you can use to enter a 
command. However, the total number of characters in a command string must 
not exceed 255. 


2.1.3 Entering Comments 


Comments explain or document commands or files. You indicate a comment by 
preceding it with an exclamation mark (!). For example, the following line in 
a command procedure uses a comment to explain the use of the DIRECTORY 
command in a control file: 


S$ DIRECTORY W:[*,*] !W: is a logical name for disk DB2: 


All the text (and spaces) starting at the exclamation point to the end of the 
line is considered a comment. The comment does not affect the action of the 
DIRECTORY command. 


Comments are valid in the following positions: 


e As the first item on a command line; in this case, the entire line is considered 
a comment and is not processed. 


e Following the last character in a command string, or after a hyphen that 
signals continuation in a command line. 
For example: 


S$ !THIS ENTIRE LINE IS A COMMENT <RET> 
S PRINT MYFILE - ! PRINT COMMAND COMMENT <RET> 
Continue: /COPIES=3 ! 3 COPIES, PLEASE <RET> 


The system prints the "Continue:" prompt in the last line to show that what 
follows is a continuation line. 


When you continue a command on more than one line, RSTS/E uses the Continue: 
prompt to indicate that it is still accepting the command. Note that the hyphen 
to continue the command must come before the comment. Hyphens after the ex- 
clamation point (!) are ignored. This means that you cannot continue comments, 
although the next line could read: 


S - ! Comment included. <RET> 


In this last line, you have no command, just a comment. 


2.1.4 Abbreviating Keywords 


Keywords are the command names, qualifiers, or options that RSTS/E recog- 
nizes. You can abbreviate all RSTS/E keywords by truncating (abbreviating) them 
to the first four characters. You can also abbreviate many of these keywords to 
two or three characters, if the keyword remains unique. You can abbreviate: 


e¢ Command names 


¢ Command keyword parameters 
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e Qualifiers 


° Qualifier keyword values 


The following sections describe the rules for abbreviating keywords. 


2.1.5 Abbreviating Command Names 


You can abbreviate command names to two characters if the abbreviation is 
unique. For example, the PRINT command is the only command that begins with 
the characters "PR." Therefore, you can abbreviate the PRINT command to two 
characters. The DEALLOCATE and DEASSIGN commands, however, have the 
same first three characters, so you cannot abbreviate these commands to fewer 
than four characters. 


2.1.6 Abbreviating Parameters, Qualifiers, and Qualifier Arguments 


You can also abbreviate parameters, qualifiers, and qualifier arguments to two 
characters if the abbreviation is unique. For example, /SIZ is the minimum 
abbreviation of the /SIZE qualifier; fewer than three characters conflicts with 
/SINCE. (Note that the slash (/) character is not considered when counting 
characters. ) 


Some qualifiers permit a negative form. For example, /NOJOURNAL is the 
negative form of the /JOURNAL qualifier. In applying the minimum four- 
character abbreviation rule, do not count the NO prefix as the first two of the four 
characters. In this case, the minimum abbreviation that guarantees uniqueness 


is /NOJOUR. 


The underscore (_), as in the (NO]D_LINES qualifier, is considered optional 
syntax. This means that the minimum abbreviation for guaranteed uniqueness is 
/D_LIN and /NOD_LIN. 


2.2 Entering File Specification Lists 


An input file parameter for many commands has the format: 
file-spec[,...] 


This format indicates that you can enter more than one file specification. You can 
separate the file specifications with commas (,) or plus signs (+). See Table 2—2 
for further discussion. 


Any number of blanks or tab characters can come before or follow the commas or 
plus signs. RSTS/E treats the list of file specifications as a single parameter. 


2.2.1. Entering Entry Specifications 


An entry specification parameter, used in Print/Batch Services (PBS) commands, 
has the format: 


queue-name:[ppnlentry-spec 
This format indicates: 


e The queue in which the print or batch entry is to be placed. 
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e The project-programmer number (PPN) assigned to the entry. 


If you do not specify a PPN, the default is your own. (Unless you have 
sufficient privileges, you cannot specify a PPN different from your own.) 


e The name of the print or batch entry. 


See Chapter 7 for more information on print and batch entries. 


2.2.2 Entering Qualifiers 


Commands can take one or both of the following types of qualifiers: 
¢ Command qualifiers 


e §6©File qualifiers 


Command qualifiers have the same meaning regardless of whether they appear 
after the command name or after a parameter. For example: 


$ PRINT/QUEUE=LP1: SPRING.SUM,FALL.SUM <RET> 
$ PRINT SPRING.SUM, FALL.SUM/QUEUE=LP1: <RET> 


In this example, the /QUEUE qualifier is a command qualifier; therefore, the two 
PRINT commands are the same. 


Unlike command qualifiers, file qualifiers can have different meanings depending 
on where you place them in the command line. If you specify a file qualifier 
immediately after a file specification parameter, it affects only the file it follows. 
If you specify a file qualifier after the command name, it affects all the files 
specified as parameters. 


For example: 


$ PRINT/COPIES=2 SPRING.SUM,FALL.SUM <RET> 
$ PRINT SPRING. SUM/COPIES=2,FALL.SUM <RET> 


The first PRINT command requests two copies of each of the files SPRING.SUM 
and FALL.SUM. The second PRINT command requests two copies of the file 
SPRING.SUM, but only one copy of FALL.SUM. 


In some cases, you can specify file qualifiers only after a parameter—not after the 
command name. (For example, the /LIBRARY qualifier used with the MACRO 
command.) In this case, the qualifier description indicates that the qualifier can 
apply only to a file parameter. In general, however, if you specify a file qualifier 
following the command name, the qualifier applies to all files specified. 


2.2.3 Determining Qualifier Defaults 


Many of the command formats in this manual show defaults. When you do 

not explicitly include a qualifier in a command line, RSTS/E assumes a default 
qualifier. For example, when you copy a file, RSTS/E normally displays a message 
confirming that the COPY operation was successful. If you type /NOLOG in the 
command line, you suppress the message. Otherwise, RSTS/E assumes the /LOG 
qualifier and displays the message. 
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2.2.4 Entering Qualifier Arguments — 
Many qualifiers can be followed by a keyword, file specification, character string, 
or numeric value. 


You must separate a qualifier and value with either an equal sign (=) or colon (:). 
For example, the following specifications are the same: 


/OUTPUT=DB1 :NEW.DAT /OUTPUT:DB1:NEW.DAT 


Many qualifiers accept one keyword or variable value. This manual presents this 
format as: 


/qualifier=value 
For example: 


/COPIES=3 
/DATE=MOD IFIED 


2.2.5 Entering Output File Qualifiers 


Some qualifiers request output from a command and optionally accept a file 
specification value. For example, the /LIST and /OBJECT qualifiers for the 
compilers, as well as the /EXECUTABLE and /MAP qualifiers for the LINK 
command, are output file qualifiers that fit into this category. 


The following rules apply to output file qualifiers: 


e 6If the qualifier is present by default, the output file specification defaults to 
your directory on the public disk structure and the name of the first input 
file. The qualifier provides a default file type. For example: 


Command Output File 
LINK A A.TSK 
LINK A,B A.TSK 
LINK [52,20]A,[52,20]B A.TSK 
LINK A.OBJ A.TSK 


e If the qualifier does not specify an output file specification, the output file 
specification defaults to your account on the public disk structure and the 
name of the first input file. The qualifier provides a default file type. For 


example: 

Command Output File 
LINK/EXECUTABLE A A.TSK 
LINK/EXECUTABLE A,B A. TSK 
LINK/EXECUTABLE A.OBJ A.TSK 


2-8 Using RSTS/E Commands and Command Procedures 


e If you specify /LIST without a file specification, the listing goes where the 
object file goes, but it has a .LST file type. If you do not specify an object file, 
then the listing has the same name as the first input file, an .LST file type, 
and is in your directory on SY:. 


e If you specify /MAP without a file specification, the map goes where the 
executable file goes, but it has a .MAP file type. If you do not specify an 
executable file, then the map has the same name as the first input file, a 
.MAP file type, and is in your directory on SY:. 


e If the qualifier indicates a file specification for the output file, then any parts 
entered in the file specification are used to name the output file, and no 
default file name is supplied. For example: 


Command Output File 
LINK A,B/EXECUTABLE=C C.TSK 
FORTRAN/LIST=A B+C A.LST, B.OBJ 
LINK/EXE=[52,20]A [52,20JA.TSK 


2.2.6 Entering Uppercase, Lowercase, and Nonalphanumeric Characters 


You should remember the following rules when you enter RSTS/E commands: 


e You can use any combination of uppercase and lowercase letters; both are 
treated the same. 


e RSTS/E treats multiple blanks and tabs the same as a single blank. 


RSTS/E ignores blanks and tabs at the beginning or end of the command 
string, around commas and plus signs, around equal signs, and around colons 
that delimit qualifier values. RSTS/E does not permit blanks or tabs in file 
specifications, dates and times, keywords, or numbers. 


e You can use quoted, or literal, strings in some RSTS/E commands (such as 
REQUEST) and in network file specifications. A quoted string consists of 
characters enclosed in quotation marks. 
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Table 2—2 lists nonalphanumeric characters that have special meanings in 


RSTS/E. 


Table 2-2: Nonalphanumeric Characters 


Symbol 


@ 
<SPACE> 


<TAB> 


Name 


Colon 


Slash 
Plus sign 
Comma 


Hyphen 


Square brackets 
Question mark 


Equal sign 


Asterisk 

Period 
Exclamation point 
Quotation mark 
Apostrophe 

Dollar sign 


At sign 
Space 


Tab 


Meaning 
A colon can serve one of the following functions: 


e Device name delimiter in a file specification. 
e Node name delimiter; used as a double colon (::). 


e Qualifier value delimiter; separates a qualifier 
name from its value. 


Qualifier delimiter. 
List element separator for parameters. 
List element separator for parameters. 


Continuation character. As the last nonblank char- 
acter in a command string, indicates that a continu- 
ation line follows. If the statement to be continued 
contains a comment, the hyphen must be the last 
nonblank character before the exclamation point. 


Directory delimiters in a file specification. 
Wildcard character in a file specification. 


Qualifier value delimiter; separates a qualifier name 
from its value. 


Wildcard character in a file specification. 
File type delimiter in file specifications. 
Comment delimiter. 

Literal string delimiter. 

Symbol substitution delimiter. 


Command file character. Used as the first character 
in first position of a command file statement. In a file 
specification, denotes the directory [1,2], which is the 
system library. 


Kixecutes a command procedure interactively. 


Separates fields in a command string. Otherwise 
ignored unless embedded in a string delimited by 
quotation marks. 


Separates fields in a command string. (Equivalent to 
one space [blank] character; otherwise ignored. ) 
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2.2./ Entering Dates and Times 


Some RSTS/E commands let you specify a date or time when the command will 
take effect. For example, you can print 10 copies of a file to be printed after 5:00 


PM on a weekend, when fewer people need the line printer, by typing a line such 
as: 


$ PRINT NOTIN.NOW/COPIES=10/AFTER=15-JUN-90:5:00PM <RET> 
In RSTS/E, you can specify the following date and time formats: 
e Absolute — A specific date and time of day. For example: 


15-Jun-1990:10:53:22 


¢ Relative — A date or time calculated from the current date or time. For 
example: 


+3DAYS or +2HOURS 


e Combinations of absolute and relative dates and times. For example: 


TOMORROW+3DAYS~-1HOUR 


2.2.8 The /BEFORE, /SINCE, and /AFTER Qualifiers 


You can specify a date with any command that allows the /SINCE or /BEFORE 
qualifier. (Generally these commands are used for working with files.) The 
/SINCE=date qualifier applies to files that are created or modified on or since 


the specified date, depending on whether or not you also use the /CREATED or 
/MODIFIED qualifier. 


The /BEFORE=date qualifier applies to files that are created or modified before 


the specified date, depending on whether or not you also use the /CREATED or 
/MODIFIED qualifier. 


You can use the /SINCE and /BEFORE qualifiers together to provide a range of 
dates for file operations. 


The /AFTER qualifier lets you specify a date, a time, or both. Use /AFTER with 
commands that affect jobs in a batch or print queue, to indicate that the system 


should not begin executing the batch job, or print the file, until after a specified 
time. 


2.2.9 Absolute Date and Time Formats 


There are three formats for absolute dates: 


¢ The alphanumeric format is dd-mmm-yy, as in 23-MAR-90. In this format, 
dd is the date of the month; mmm is the first three letters of the month; and 
yy is the last two digits of the year, or the entire year (as in 1990). The yy 


is optional—you can just type dd-mm. If you omit the year, RSTS/E assumes 
the current year. 


¢ The numeric format is yy.mm.dd, as in 90.3.23 (for March 23, 1990). In this 
format, yy is the last two digits of the year or the entire year (as in 1990); 
mm is the month; and dd is the date of the month. 
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e Use these keywords to specify a date: TODAY, TOMORROW, or YESTERDAY. 


NOTE 


You can specify any date from 1-JAN-70 to 31-DEC-99, inclusive. If you 
specify a date outside that range, you get the message: 


?Invalid date 


There are two formats for absolute times: 24-hour time and AM/PM time. 


e A 24-hour time has the form hh:mm. In this format, hh is the hour, in the 
range 0 to 24, and mm is the minute, in the range 0 to 59. The minute is 
optional. The default minute is 00. For example, 11 is equivalent to 11:00. 
The limits of time formats are: 


— 00:00 is midnight, and is considered the beginning of the specified date. 
—- 12:00 is noon. 
— 24:00 is midnight, and is considered the end of the specified date. 


e¢ An AM/PM time can be in the format hh:mmAM, hh:mmPM, or 12:00M. In 
this format, hh is the hour, in the range 1 to 12; mm is the minute, in the 
range 0 to 59; and M (for meridian) stands for noon. You can use either 00:00 
or 24:00 to specify midnight. 


2.2.10 Combinations of Absolute Dates and Times 


The order for specifying both a date and time is date:time. For example: 
23-JUN-90:11:00AM 


TOMORROW: 1:00AM 


If you specify just a time, RSTS/E assumes TODAY. If you specify just a date 
when using the /AFTER qualifier, then RSTS/E assumes 11:59PM. (In other 
words, the job processes after the end of the specified day.) 


2.2.11 Syntax 


The punctuation marks (syntax) in a time specification indicate the time value 
you enter. If you specify both the date (dd-mmm-yy) and the time (hh:mm), you 
must type the colon between the date and the time. 


A line ending with a hyphen (-) is continued, rather than recognized as a part of 
the date. For example: 


§ PRINT/AFTER=15- 
CONTINUE: <RET> 


This PRINT command specifies 3:00 PM today, according to 24-hour time. 


2-12 Using RSTS/E Commands and Command Procedures 


2.2.12 Relative Date and Time Formats 


In addition to absolute dates and times, you can also specify relative dates and 
times. There are three formats for relative dates and times: 


e + or -nD[AYS]. For example: 
+23D or -2DAYS 

e +or-nH[OURS]. For example: 
+23H or -8HOURS 

e +or-nM[INUTES]. For example: 
+30M or -15MINUTES 


You may specify these formats in any order or in any combination you choose. 


If you specify a relative date, you may or may not want to also specify either an 
absolute or relative time, with the following results: 


e If you do specify an absolute time, then that time is used. For example, 
PRINT/AFTER=3PM+2DAYS means 2 days from today at 3:00 PM. 


e If you do not specify an absolute time, but specify only a relative time, then 
the time is calculated from the current time. For example (if it is currently 
1:45 PM), PRINT/AFTER=TOMORROW+2HOURS means tomorrow at 3:45 
PM. 


¢ If you do not specify a time at all, then time is not considered. For example, 
PRINT/AFTER=05-AUG+3DAYS means first thing on August 9th; this has 
the same result as specifying /AFTER=08-AUG. 


Some other examples of specifying relative dates and times are: 


e To print out a listing three days from today starting at 3:00 PM, type: 


PRINT/AFTER=3 : 0OOPM+3DAYS 


e¢ To print a file tomorrow at the same time as today, type: 


PRINT/AFTER=TODAY+0HOURS 


or 
PRINT/AFTER=+24HOURS 


e To set up a batch job named WEEKLY that resubmits itself every seven days 
starting at 2 PM, type the following command in WEEKLY.COM: 


SUBMIT/AFTER=2:00PM+7DAYS WEEKLY .COM 


2.3 Using Command Procedures 


Command procedures are files that contain DCL commands. You execute 
these commands by running the procedure. Use command procedures to 
execute sequences of commands you use during interactive terminal sessions or 
commands you submit for batch processing. To fully understand how to use 
command procedures on RSTS/E, see the RST'S/E Guide to Writing Command 
Procedures. 
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Command procedures can range from simple to complex. A simple command 
procedure consists of one or more command lines for the DCL command 
interpreter to execute. For example, the following command procedure deletes all 
temporary (.TMP) files and then shows a directory listing: 


DIRECT.COM 


$ ! Delete .TMP files and show directory 
$ DELETE *.TMP 
$ DIRECTORY 


A more complex command procedure performs program-like functions. It can: 
¢ Contain loops and error checking routines 

e Perform arithmetic calculations and input/output (I/O) operations 

e Manipulate character string data 


e Call or pass parameters to other command procedures 


For example, the following command procedure displays all occurrences of files 
with a .B2S file type in a user’s account: 


B2S.COM 
$ ! Display all .B2S files 
S$ NEXT FILE = FSSEARCH(" SY:*.B2S") 
$ LOOP: 
S IF NEXT FILE .EQS. "" THEN EXIT 
S WRITE 0 NEXT FILE 
$ NEXT FILE = FSSEARCH() 
$ GOTO LOOP 


2.3.1 Creating Command Procedures 


To create a command procedure, use either a text editor (such as EDT) or the 
DCL CREATE command. The following example shows how to create a simple 
command procedure using EDT: 

§ EDIT/EDT RUN.COM <RET> 

Input file does not exist 

[EOB] 

S !Run three programs 

S RUN PROG1 <RET> 

S RUN PROG2 <RET> 

$ RUN PROG3 <RET> 


<CTRL/Z> 


*EXIT 
RUN.COM 4 lines 


$ 
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The next example shows how to create the same procedure using the DCL 
CREATE command: 


S$ CREATE RUN.COM <RET> 
$ !Run three programs 
$ RUN PROG1 <RET> 

$ RUN PROG2 <RET> 

S$ RUN PROG3 <RET> 
<CTRL/Z> 

$ 


Note that the examples use the file type .COM. When you enter the at (@) 
command at the DCL prompt, the command interpreter assumes that the at 
sign (@) character is followed by the name of a file with the file type .COM. In 
addition, if you enter the @ command without specifying a file, RSTS/E prompts 
you for the file specification. 


2.3.2 Formatting Command Procedures 


When you create a command procedure, start each command line with a dollar 

sign ($) character. The use of the $ character ensures that DCL will process the 
command when you execute the procedure from another keyboard monitor such 
as BASIC-PLUS. Omit the $ character for data lines. 


2.3.3 Executing Command Procedures 


You can execute command procedures in many different ways on RSTS/E systems. 
For example: 
e 6At login time, using LOGIN.COM files 


e At DCL command level, using the at sign (@) command (or from any other 
keyboard monitor, using the $ character before the @ command) 


e In batch processing, using the SUBMIT command 
e From inside another command procedure (nesting) 


e With the RUN command from any keyboard monitor, providing the command 
file is executable 


See the RSTS/E Guide to Writing Command Procedures for a complete descrip- 
tion of each method of executing command procedures. 
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Chapter 3 
WORKING WITH FILES 


This chapter describes DCL commands that are used in file operations. 


Table 3—1 lists the commands as they appear in this chapter. 


Table 3-1: Commands for File Operations 


Command 


CREATE 
EDIT 


DIRECTORY 
TYPE 


DELETE 


COPY 
RENAME 
APPEND 


BACKUP 
BACKUP/DIRECTORY 
RESTORE 


RESTORE/DIRECTORY 


SORT 


Meaning 
Creating and Modifying Text Files 


Lets you enter text that you can save as a file. 


Starts the EDT text editor. 


Displaying File Names and Files 
Displays information about files in a directory. 


Displays the contents of individual text files at the terminal. 


Deleting Files 
Deletes files from a directory. 


Copying, Renaming, and Appending Files 


Duplicates a file or concatenates files. 
Assigns a new name to a file. 


Copies a file to the end of another file. 


Backing Up and Restoring a Directory of files 


Creates a Backup set on a specified disk or magnetic tape. 
Lists files contained in an existing Backup saveset. 


Restores a RSTS/E disk or subset of that disk from a tape or disk Backup 
set. 


Allows Restore to lists files contained in an existing backup saveset. 


Sorting and Merging Files 


Invokes the PDP-11 SORT utility to reorder the contents of a file or files, 
and combine several sorted files into a single output file. 


(continued on next page) 
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Table 3-1 (Cont.): Commands for File Operations 


Command 


MERGE 


DIFFERENCES 


SET PROTECTION 


SET FILE 


Meaning 
Sorting and Merging Files 


Invokes the PDP-11 MERGE utility to combine two through ten similarly 
sorted input files and create a single output file. 


Comparing Files 


Creates a new file that lists differences in the text of two other files. Use 
DIFFERENCES to compare earlier versions of a file with its later versions. 


Allowing Access to Your Files 


Specifies the protection code of a file to determine who, if anyone, can 
read, modify, or delete a file. The /DEFAULT qualifier assigns the same 
protection code to all the files you create in a session at the terminal. 


Setting File Characteristics 


Sets various characteristics of a specified file. 


3.1 Creating and Modifying Text Files 


The CREATE and EDIT commands let you create files in DCL. 


3.1.1 CREATE 


The CREATE command lets you enter text and save it as a file. 


Although you will use the EDIT command more often than CREATE to create 
files, the CREATE command is useful when you want to: 


e Preallocate (set) the size of a file 


e Create a file from a command procedure 


There is less overhead when you preallocate the size of a file, because the system 
assigns enough space for the file only once, rather than having to assign more 
space several times as the file grows larger. 


Because preallocation causes less overhead, access to the file is faster. Allocating 
the size of a file is not necessary, but it is occasionally useful if a program will be 
using the file. Preallocation avoids possible overhead caused when the file size is 
extended by the program’s use. 


You also preallocate the size of a file if you need a contiguous file of a specific size. 
You must specify /ALLOCATION with the /CONTIGUOUS qualifier. 


While you are creating a file with the CREATE command, you can use the Delete 
and Ctrl/U keys to delete text on the current line. When you are finished entering 
text, you press Ctrl/Z to save the text as a file. 
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Format 


CREATE file-spec 


Command Qualifiers Defaults 
/ALLOCATION=n /ALLOCATION=0 
/CLUSTER_SIZE=n none 
/[INOJCONTIGUOUS /NOCONTIGUOUS 
/POSITION=n /POSITION=0 

=MIDDLE 

=INDEX 
/PROTECTION=n none 
/[NOJREPLACE none 
Prompts 


File: file-spec 
OK to replace existing file filespec ? 


Command Parameters 


File-spec 
Specifies the name of the file to be created. You cannot use wildcard characters in 
the file specification. 


Command Qualifiers 


/ALLOCATION=n 

Creates space on the disk by forcing the initial allocation of the file to a number 
of 512-character blocks, which you specify with n. The following example provides 
three blocks of space to create a file named BOSTON.MAR: 


S CREATE BOSTON.MAR/ALLOCATION=3 <RET> 


/CLUSTER_SIZE=n 

Establishes the cluster size for a disk file. A cluster is a number of contiguous 
blocks taken together as a unit. The cluster size is the minimum unit of allocation 
for the file. 


This qualifier is useful for large files. By specifying a large cluster size, you can 
speed up random access to the data. See Appendix B for more information on 
specifying cluster size. 


/CONTIGUOUS 

/NOCONTIGUOUS 

Indicates whether or not the file is to be contiguous, which means that the file 
occupies consecutive physical disk blocks. 


If you do not specify an allocation, or if the allocation is too small, you get the 
following error message when the system tries to increase the size of the 
contiguous output file: 


?Protection violation 
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/PROTECTION=n 
Specifies the protection code of the file. 


RSTS/E normally assigns files a protection code of 60, unless your system 
manager has changed the default. If you use the SET PROTECTION/DEFAULT 
command before creating the file, the protection code becomes the value you 
specified as the default. See the SET PROTECTION command at the end of this 
chapter. 


/POSITION=n 

/POSITION=MIDDLE 

/POSITION=INDEX 

Specifies the starting position of the target file on disk. This qualifier is ignored 
for files created on devices other than disks. 


If you specify /POSITION with an argument, then that value indicates the start- 
ing disk cluster at which to place the file. The minimum value is 0 (beginning 
of disk) and the maximum value is the disk’s maximum cluster number. If you 
specify 0 (the default), the file is created at the first available cluster on the disk. 


If you specify /POSITION=MIDDLE, the file is created at the first available 
cluster past the middle of the disk. 


If you specify /POSITION=INDEX, the file is created at the first available cluster 
following the storage allocation table (SATT.SYS) on the disk. 


/REPLACE 

/NOREPLACE 

/REPLACE requests that if a file already exists with the same file specification as 
the one you are creating, the existing file is to be deleted. 


For example, if there is a file named BLACK.CAT in your directory, and you want 
the file you are creating to replace the existing file, type: 


$ CREATE BLACK.CAT/REPLACE <RET> 


If the CREATE command is going to replace an existing file, but you do not 
specify /REPLACE or /NOREPLACE, DCL displays the prompt: 


OK to replace existing filespec ? 
You can reply with one of the following: 
Y Yes, replace the file 

N No, do not replace the file 
<RET> No, do not replace the file 


/NOREPLACE forces the CREATE command to fail if the file being created 
already exists. In addition, it suppresses the "OK to replace existing filespec?" 
prompt. 


If you use the CREATE command in a command procedure, you should explicitly 
specify either /REPLACE or /NOREPLACE., This prevents DCL from issuing the 
"OK to replace existing filespec?" prompt. 
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3.1.2 EDIT 


Format 


The EDIT command starts the EDT editor program, which lets you create and 
edit text files. 


This section provides basic command and syntax information for the EDIT 
command. To learn about editing text with the EDT editor, see the Introduction 
to the EDT Editor, which is a tutorial manual that you can use at your terminal. 
For details about each command and feature of EDT, see the EDT Editor Manual. 


You can also get information about EDT while using it. EDT’s help facility 
provides a description about each of its editing commands. After you use the 
EDIT command to start EDT, type HELP after the asterisk (*) prompt for help 
text. (In keypad editing, you press the HELP key for help text. See the EDT 
Editor Manual for details.) 


EDIT  file-spec 


Command Qualifiers Defaults 
/[NO]COMMAND[sfile-spec] /COMMAND=EDTINI.EDT 
/[NO]JCREATE /CREATE 

/EDT /EDT 
/FORMAT=STREAM /FORMAT=STREAM 
/FORMAT=VARIABLE See discussion 
/[NO]JJOURNAL[=file-spec] /JOURNAL 
/[NOJOUTPUT [=file-spec] /OUTPUT 
/[NO]JREAD_ONLY /NOREAD_ONLY 
/[NOJRECOVER /NORECOVER 
Prompts 


File: file-spec 


Command Parameters 


file-spec | 
Specifies the file to be created or edited using the EDT editor. If the file does not 
exist, it is created. 


The only part of the file specification that you must supply is the file name. EDT 
does not provide a default file type when creating files; if you do not include a file 
type, no file type is assigned. 


You cannot use wildcard characters in the file specification. 
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Command Qualifiers | 


/COMMAND[sfile-spec] 

/NOCOMMAND 

Controls whether or not EDT reads a command file before prompting at the 
terminal. If you specify a command file, EDT executes all commands in the file 
before beginning the editing session. For example, if you have a file named 
CHANGE.INI containing line editing commands, you use it when editing the file 
RUN.DAT by typing: 


$ EDIT RUN.DAT/COMMAND=CHANGE.INI <RET> 


By default, EDT looks for a command file named EDTINI.EDT when you begin 
an editing session. If the file EDTINI.EDT is in your directory on the public 
structure, EDT uses the commands it contains when the session begins. If 

you specify the /NOCOMMAND qualifier, EDT does not read a command file 
before beginning the editing session. To suppress the effects of the command file 
EDTINI.EDT when you start an editing session with file RUN.DAT, type: 


$ EDIT RUN.DAT/NOCOMMAND <RET> 


Otherwise, the commands in the EDTINI.EDT file automatically affect your 
editing session. 


You cannot use wildcard characters in the command file specification. 


/CREATE 

/NOCREATE 

Controls whether or not to open a new file when the specified file does not exist. 
The default is /CREATE. 


/EDT 

Makes sure that the EDIT command starts EDT, if your system manager has 
changed the default on your system from EDT to another editor. Otherwise, you 
do not need to use this qualifier. 


For example: 
$ EDIT/EDT NEWFIL.RNO <RET> 


The EDT editor is invoked, so you can produce a file named NEWFIL.RNO. 


/FORMAT=STREAM 
/FORMAT=VARIABLE 
Determines the format of the output file. 


/FORMAT=STREAM creates the file in stream ASCII format. The default is 
/FORMAT=STREAM. /FORMAT=VARIABLE creates the file in variable-length 
format. See the RMS-11 User’s Guide for information about stream and variable 
file formats. 


/JOURNAL[=file-spec] 

/NOJOURNAL 

Controls whether or not a journal file is created for the editing session. A journal 
file contains a copy of the edits you make to another file, from the beginning to 
the end of the editing session. If your editing session ends abnormally (as ina 
system failure or "crash"), you can restart EDT (using the /RECOVER qualifier) 
and reinstate all commands from the aborted session. 


When you begin an editing session, EDT automatically creates a journal file with 
the same name as the input file and a .JOU file type. If you are editing a file 
named RUN.DAT, for example, the journal file is named RUN.JOU. 
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The command line to state explicitly that you want a journal file when you edit 
RUN.DAT, and to name the journal file RUNDAT-V01 is: 


$ EDIT RUN.DAT/JOURNAL=RUNDAT.VO1 <RET> 
If you specify the /NOJOURNAL qualifier, no journal file is created. 


If you omit the /JOURNAL qualifier or if you specify the qualifier without a file 
specification, the editor creates a journal file with the same file name as your 
input file and a default file type of JOU. EDT also assumes a default file type of 
JOU if you specify a file name but not a file type when you use the /JOURNAL 
qualifier. 


Your directory contains the journal file when the system resumes operation after 
a system crash. By default, EDT places the journal file in the same directory 
and device as the output file, if you specified /OUTPUT when creating the file. 
Otherwise, EDT uses the same directory and device as the input file. 


For example, suppose you start a session to edit the existing file MARY.DAT, but 
you want the finished output file to become file BETH.DAT: 


$ EDIT MARY.DAT/OUTPUT=BETH.DAT <RET> 


If the system crashes, the journal file is named BETH.JOU. You can then recover 
from a system crash by typing: 


$ EDIT MARY.DAT/OUTPUT=BETH.DAT/RECOVER <RET> 


If you used the /OUTPUT qualifier to invoke EDT, you must also use it when 
you recover the file. (The journal file does not "remember" the command line you 
typed to begin the editing session.) 


You cannot use wildcard characters in the journal file specification. 

You cannot use /NOJOURNAL if you specify /NOREAD_ONLY. 
/OUTPUT[=file-spec] 

/NOOUTPUT 

Defines the file specification of the file created during the editing session. If you 
do not specify the /OUTPUT qualifier, the output file replaces the input file, and 


the previous version of the input file is saved as filename.BAK. EDT deletes any 
previous file named filename.BAK. 


For example, suppose you type: 
$ EDIT PAPER.NUM <RET> 


If you continue the editing session and then exit from EDT by saving your edits, 
EDT automatically creates a new output file named PAPER.NUM. The file you 
began the session with is renamed to PAPER.BAK. 


If you want the output file to be named something other than the original file 
name, you can specify the output file name explicitly. For example, the following 
command line tells EDT to put the contents of the file you are about to update 
into a file named SUPPLY.DAT: 


$ EDIT PAPER.NUM/OUTPUT=SUPPLY.DAT <RET> 


You cannot use wildcard characters in the file specification. 


WORKING WITH FILES 3-7 


You can suppress the creation of the output file with the /NOOUTPUT qualifier. 
For example: 


$ EDIT PAPER.NUM/NOOUTPUT <RET> 
Use of the /NOOUTPUT qualifier does not suppress creation of the journal file. 
You cannot use /OUTPUT if you specify /READ_ONLY. 


/READ_ONLY 

/NOREAD_ONLY 

Controls whether EDT disables journaling and the creation of an output file 
when you view a file. The /READ_ONLY qualifier is equivalent to specifying 
/NOOUTPUT and /NOJOURNAL. You can use the /READ_ONLY qualifier to 
examine files without modifying them. 


The default is /NOREAD_ONLY, which allows journaling and output. 


/RECOVER 

/NORECOVER 

Determines whether EDT reads commands from a journal file before starting the 
editing session. The /RECOVER qualifier is useful if you are editing a file and 
the system crashes, as in the case of a power failure. The /RECOVER qualifier 
lets you restore your work on the file. The default is /NORECOVER, which tells 
EDT not to recover the edits you made to the file. 


For example, if you are editing file PAPER.NUM when the system ceases 
operations, or crashes, you can use the /RECOVER qualifier to restore your work 
when the system is back in operation: 


S EDIT PAPER.NUM/RECOVER <RET> 


If you named the journal file something other than PAPER.JOU (for example, 
to REAMS.DAT) when you began the previous editing session, use the following 
command line when restoring your work: 


S EDIT PAPER.NUM/RECOVER/JOURNAL=REAMS.DAT <RET> 
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3.2 Displaying File Names and Files 
The DIRECTORY command displays information about files. Use the TYPE 


command to display the contents of individual files. 


3.2.1 DIRECTORY 
The DIRECTORY command displays information about files. 


Format 
DIRECTORY _[file-specy....]] 
Command Qualifiers Defaults 
/BEFORE=date none 
/BRIEF See discussion 
/CREATED none 
/DATE[=CREATED] /INODATE 
[=_MODIFIED] 
[=ALL] 
/NODATE none 
/FULL none 
/MODIFIED none 
/OUTPUT=file-spec none 
/[NO]JPROTECTION /PROTECTION 
/SELECT=SIZE=n See discussion 


=SIZE=MINIMUM=n 
=SIZE=MAXIMUM=n 
=SIZE=(MINIMUM=m,MAXIMUM=n) 


/SINCE=date none 

/SIZE[=ALLOCATION] /SIZE=USED 
[=USED] 

/NOSIZE /SIZE 

[TOTAL none 

Prompts 


If you type the DIRECTORY command and press the RETURN key, DCL lists the 
files in your directory on the public structure. For example: 


$ DIRECTORY <RET> 


Name .Typ Size Prot Name .Typ Size Prot 8Y¥t [52,20] 
FINISH.COB L230 < 60> TEN -K 4 < 60> 

START .BAS 89 < 60> ROAD .MAP i < 60> 

TEMP16.TMP 258 < 60> 


Total of 484 blocks in 5 files in SY:[52,20] 
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You can see directory listings only of files to which you have access (read, write, 
or execute). If you specify a file or directory which is not yours, and to which you 
do not have access, one of the following error messages is displayed: 


?File does not exist 
?Can’t find file or account 


Command Parameters 


file-spec{,...] 

Specifies one or more files to be listed. If your installation has DECnet/E, you 
can also specify the node on which the files are located. The default is the local 
node. 


The rules for using the file specification are: 


e If you do not enter a file specification, the DIRECTORY command lists all the 
files in your directory on the system disk. 


e If you specify only a device name, the DIRECTORY command lists the files in 
your directory on that device. For example, if you have files on a disk named 
DB1:, you can type: 
$ DIR DB1: <RET> 


e If you use wildcards for a file name or type, RSTS/E displays all files with 
that name or type. For example, if your account contains files named RACE.1, 
RACE.2, and RACE.3, you can type: 


$ DIRECTORY RACE.* 

To get information about all the files in the directories you have access to, 
type: 

$ DIRECTORY [*,*]*.* <RET> 


This lists all files in all directories on the public disk structure. The first set 
of asterisks (in [*,*]) corresponds to every account number. The second set of 
asterisks (*.*) represents every file name and type. 


e Ifa file specification contains a file name and a wildcard for the file type, the 
DIRECTORY command assumes all file types. Similarly, you can specify a 
file type and a wildcard for the file name. Therefore, both of the following are 
valid command lines: 


S$ DIRECTORY RACE.* <RET> 
S DIRECTORY *.1 <RET> 


If you provide more than one file specification, separate the file specifications 
with commas (,) or plus signs (+). You can use wildcard characters in the 
directory specification, file name, or file type of a file specification to list all 
files that satisfy the elements you specify. For example: 


$ DIRECTORY RACE.1,*.DAT,DB1:*.* <RET> 


3-10 WORKING WITH FILES 


Command Qualifiers 


/BEFORE=date 
Specifies that only those files created or modified earlier than a given date be 
listed. See Chapter 2 for the syntax to specify dates. 


You can use the /BEFORE qualifier with either the /CREATED or /MODIFIED 
qualifier. For example: 


S$ DIRECTORY/CREATED/BEFORE=28-JUN-90 <RET> 


S$ DIRECTORY/MODIFIED/BEFORE=TODAY <RET> 


If you omit the /BEFORE qualifier, RSTS/E displays the files without regard to 
their dates. 


You can use /BEFORE only when listing files on the local (your own) node. 


/BRIEF 
Lists only the file name and type of each file. If you specify /BRIEF, you do not 
see the number of blocks for the files or their protection codes. For example: 


$ DIRECTORY/BRIEF <RET> 


Name .Typ Name .Typ Name .Typ Name .Typ 
SY: [52,20] 
ROAD .MAP TEMP25.TMP STRIDE.TXT PACE .DAT 


4 files 25 blocks 


If you do not specify /BRIEF, the sizes and protection codes are also included in 
the display. 


/CREATED 
Selects the files according to their dates of creation. Use the /CREATED qualifier 
only with the /BEFORE or /SINCE qualifiers. For example: 


$ DIRECTORY/BEFORE=10-JUN-90/CREATED <RET> 


Name .Typ Size Prot Name .Typ Size Prot 8Y:[(52,20] 
ROAD .MAP dt < 60> STRIDE. TXT 21 < 40> 
PACK .DAT 8 < 60> 


Total of 33 blocks in 3 files in SY: [52,20] 


Do not use /CREATED with the (MODIFIED qualifier. (You can select files either 
according to their date of creation or date of modification, but not both.) After a 
file is created, any later updates cause the file to be modified. 


By default, the selection of files according to a date uses the creation date. 


You can use /CREATED only when listing files on the local (your own) node. 


/DATE=CREATED 

/DATE=MODIFIED 

/DATE[=ALL] 

The /DATE qualifier causes the DIRECTORY listing to include the date when 
a file was created or last accessed, or both. If you specify /DATE without an 
argument, /DATE=ALL is the default. 


/DATE=CREATED requests information about the file’s creation date and time: 


$ DIRECTORY/DATE=CREATED <RET> 


Name .Typ Size Prot Date Time SY: [52,201 
ROAD - MAP 4 < 60> 14-Jun-90 10:13 AM 


Total of 4 blocks in 1 file in SY: [52,20] 


WORKING WITH FILES 3-11 


/DATE=MODIFIED displays the date when the file was last updated or accessed: 


S$ DIRECTORY/DATE=MODIFIED <RET> 


Name .Typ Size Prot Access Name .Typ Size Prot Access 
SY: [52,20] 

ROAD .MAP 4 < 60> 08-Jun-90 STRIDE.TXT 21 

40> 14-Jun-90 


Total of 25 blocks in 2 files in SY: [52,20] 


/DATE=ALL provides date and time information about the creation and access of 
a file: 


S DIRECTORY/DATE=ALL <RET> 


Name .Typ Size Prot Access Date Time S¥: [52,20] 
ROAD .MAP 4 < 60> 08-Jun-90 14-Jun-90 04:25 PM 


Total of 4 blocks in 1 file in SY: [52,20] 


/NODATE 
Lists information about files but does not include dates. Unless you specify 
/DATE, the /NODATE qualifier is assumed. For example: 


$ DIRECTORY/NODATE <RET> 


Name .Typ Size Prot Name .Typ Size Prot Sx « [52,20] 
ROAD .MAP a < 60> STRIDE .TXT 24 < 40> 


Total of 25 blocks in 2 files in SY: [52,20] 


You can use /DATE and /NODATE only when listing files on the local (your own) 
node. 


/FULL 
Lists the following items for each file: 


e Name 

° Type 

e Number of blocks used 

e Protection 

e Date last accessed or modified 
e Creation date and time 

e Cluster size 

e Run-time system name 

e Position of first block in file 


e File attributes, if any 


The /FULL qualifier implies the qualifiers /DATE=ALL and /PROTECTION as 
defaults. The /FULL qualifier also includes information about the file’s cluster 
size (in the Clu column) and position on the disk (in the Pos column). Often the 
/FULL qualifier is used with a file specification. For example: 


S$ DIRECTORY/FULL RACE.* <RET> 


Name.Typ Size Prot Access Date Time Clu RTS Pos SY:[52,20] 
RACE .1 4 <60> 20-Jun-90 20-Jun-90 01:02 PM 4 ...RSX 22699 
RACE .2 3 <60> 20-Jun-90 20-Jun-90 09:55 AM 4 ...RSX 23284 


Total of 7 blocks in 2 files on SY:[52,20] 
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/MODIFIED 
Selects files according to the last date the file was modified. Use this qualifier 
only with the /BEFORE or /SINCE qualifiers. For example: 


S$ DIRECTORY/MODIFIED/BEFORE=12-JUN-90 <RET> 


Name .Typ Size Prot Name .Typ Size Pret SY: [52,20 
ROAD .MAP 4 < 60> STRIDE .TXT 21 < 40> 


Total of 25 blocks in 2 files in SY: [52,20] 
S DIRECTORY/MODIFIED/SINCE=18-JUN-90 


Name .Typ Size Prot Name .Typ Size Prot SY: [52,20] 
ROAD .MAP 4 < 60> STRIDE .TXT 21 < 40> 
RACE .1l 3 < 60> 


Total of 28 blocks in 3 files in SY: [52,20] 


Note that this display lists only the file name and type, file size, and protection 
code. Use /DATE=MODIFIED to display the dates of file access. 


Do not use (MODIFIED with the /CREATED qualifier. (The date you specify 
can apply only to the creation or modified date; thus, you cannot specify both 
/CREATED and /MODIFIED.) After a file is created, any later updates cause the 
file to be modified. 


You can use /MODIFIED only when listing files on the local (your own) node. 


/OUTPUT=file-spec 

Creates a file containing the output of a DIRECTORY listing, instead of display- 
ing the output at your terminal. You must include a file name with the /OUTPUT 
qualifier. If you omit the file type in the file specification, the default type is .DIR. 


For example, the following command line puts the directory listing into a file 
named RACES.DIR: 


S$ DIRECTORY/OUTPUT=RACES <RET> 
$ TYPE RACES.DIR <RET> 


Name .Typ Size Prot Name .Typ Size Prot Sie (52,20) 
ROAD .MAP 4 < 60> STRIDE.TXT 21 < 40> 
RACE .1 3 < 60> 


Total of 28 blocks in 3 files in SY: [52,20] 
$ DIRECTORY RACES <RET> 


Name .Typ Size Prot Name .Typ Size Prot SY: [52,20] 
RACES .DIR 2 <= 60> 


Total of 2 blocks in 1 file in SY: [52,20] 
Note that the output file has the type .DIR. 


You cannot use wildcard characters in the output file specification. 


/PROTECTION 
/NOPROTECTION 
Specifies the protection code of files to be in the directory listing. 


You can use this qualifier only when listing files on the local (your own) node. 
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/SELECT=SIZE=n 

/SELECT=SIZE=MINIMUM=n 
/SELECT=SIZE=MAXIMUM=n 
/SELECT=SIZE=(MINIMUM=m,MAXIMUM=n) 

Selects files based on their size. The specified size can be: 


n Selects only those files with size equal to n. 

MINIMUM=n Selects only those files with size greater than or 
equal to n. 

MAXIMUMe=n Selects only those files with size less than or 
equal to n. 

MINIMUM=m,MAXIMUMe=n Selects only those files with size between m and n 
inclusive. 

/SINCE=date 

Specifies that only those files created or modified on or after a specified date be 

displayed. 


You normally use the /SINCE qualifier with either the /CREATED or /MODIFIED 
qualifier. If you omit the /SINCE qualifier, you obtain all the files, regardless of 
creation date. The date can be either TODAY or YESTERDAY, or a date in the 
format dd-mmm-yy or yy.mm.dd (as in 12-MAY-90 or 90.5.12). For example: 


S$ DIRECTORY/CREATED/SINCE=06-APR-90 <RET> 


Name .Typ Size Prot Name .Typ Size Proc SY: [52,20] 
ROAD .MAP 4 < 60> STRIDE .TXT 21 < 40> 
RACE .1 3 < 60> 


Total of 28 blocks in 3 files in SY: [52,20] 


You can use /SINCE only when listing files on the local (your own) node. 


/SIZE=ALLOCATION 

/SIZE=USED 

The /SIZE qualifier lists the number of blocks a file either uses or is allocated. 
Compare the following two examples: 

$ DIR *.LOG/SIZE=USED <RET> 


Name .Typ Size Prot Name .Typ Size Prot sy: (52,20) 
BAR - LOG 3 < 60> FOO . LOG 6 < 40> 
LINK .LOG 12 < 60> HELP .LOG 6 < 60> 


Total of 27 blocks in 4 files in SY: [52,20] 


$ DIR *.LOG/SIZE=ALLOCATION <RET> 


Name .Typ Size Proer Name .Typ Size Prot SY: [52,20] 
BAR - LOG A < 60> FOO - LOG 8 < 40> 
LINK .LOG 12 < 60> HELP .LOG 8 < 60> 


Total of 32 blocks allocated in 4 files in SY:[52,20] 


The first example shows /SIZE=USED, which is the default. The Size column 
shows the number of blocks used by each file. By contrast, the Size column in the 
second example shows the number of blocks allocated to store each file. This may 
be larger because disk space is allocated in multiples of the file’s cluster size. 


You can use /SIZE only when listing files on the local (your own) node. 
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/NOSIZE 
The /NOSIZE qualifier suppresses information on file size. The default is /SIZE. 


[TOTAL 
The /TOTAL qualifier displays the total amount of space your files require, 
without listing information about each file. For example: 


$ DII 
SY: [52,20] 


Total of 647 blocks in 24 files in SY: [52,20] 


You can use /TOTAL only when listing files on the local (your own) node. 
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3.2.2 TYPE 


The TYPE command displays the contents of a text file (as opposed to a binary or 
temporary file) at the terminal. 


Format 
TYPE [node::]file-specyf,...] 
Command Qualifiers Defaults 
/BEFORE=date none 
/[NO]CONFIRM /NOCONFIRM 
/CREATED none 
/[NO]LOG /NOLOG 
/MODIFIED none 
/[NOJQUERY ([N}) /NOQUERY 
/SELECT=SIZE=n See discussion 
=MINIMUM=n 
=MAXIMUM=n 
=(MINIMUM=m,MAXIMUM=n) 
/SINCE=date none 
Prompts 


File: file-specy,...] 


For example, you can display the contents of the file TRAIN. TXT: 


S TYPE TRAIN.TXT <RET> 


Even though it was difficult to 
undertake a new running regime, 

I was amazed at how soon I was 
able to increase my daily mileage. 


You can control the display of a file in any of the following ways: 


e To temporarily halt the output, use Ctrl/S. To resume output where it was 
interrupted, use Ctrl/Q. This works only if your terminal has the TTSYNC 
characteristic set. (See Chapter 5 for more information on setting terminal 
characteristics.) On VT100 terminals you can also press the NO SCROLL 
key to stop and restart output. On VT200 terminals you can press the HOLD 
SCREEN key to stop and restart output. 


¢ To suppress the display but continue command processing, use Ctrl/O. If you 
press Ctrl/O again before processing is completed, output resumes at the 
current point in command processing. 


¢ To stop command execution entirely, press Ctrl/C. The use of Ctrl/C returns 
you to DCL command level. 
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Command Parameters 


file-spec{,...] 

Specifies one or more files to be displayed. If your installation has DECnet/E, 
you can specify the node where the files are located. You can also use wildcards. 
If you want to display more than one file, separate the file specifications with 
commas (,) or plus signs (+). In either case, RSTS/E displays the files in the order 
you specify. The TYPE command allows wildcards in place of the directory, file 
name, and file type fields. The following command line contains wildcards and 
commas: 


$ TYPE *.TXT,ROAD.MAP,RACE.* <RET> 


This command line displays the contents of all files having the file type .TXT, the 
file ROAD.MAP, and all files named RACE. 


Command Qualifiers 


/BEFORE=date 

/SINCE=date 

/CREATED 

/MODIFIED 

Displays files created or modified before or since the specified date. See Chapter 2 
for information on specifying dates and times. 


The following example displays all data files created before 01-Jun-90: 
$ TYPE/CREATED/BEFORE=01-Jun-90 *.DAT OLDWRK.DAT <RET> 
The following example displays all files that were modified today: 


$ TYPE/MODIFIED/SINCE=TODAY *.* NUWORK.WED <RET> 


/CONFIRM 

/NOCONFIRM 

Controls whether or not a prompt appears requesting permission to display each 
file. This qualifier is synonymous with /QUERY. The default is /NOCONFIRM. 


/LOG 

/NOLOG 

Controls whether or not a message appears for each file displayed. The default is 
/NOLOG. 


/QUERY 

/NOQUERY 

Controls whether or not the system displays the name of each file you request 
and asks if you want to see the file. (The /QUERY qualifier is useful only when 
you use wildcard file specifications in the TYPE command line.) 


For example, if you have eight files in your directory with the file type .TXT, you 
can type: 


S$ TYPE *.TXT/QUERY <RET> 
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DCL prints a file specification followed by a question mark (?) prompt. You can 
reply by typing one of the following responses: 


Y Yes, display the file 

N No, do not display the file 
<RET> No, do not display the file 
<Ctrl/Z> Quit; return to command level 


For example: 


[52,20] TRAIN .TXT? N <RET> 


[52,20]STRIDE.TXT? ¥ 


Hill training taught me that 
short, quick steps are good for 
running uphill. longer strides 
are best for downhill inclines 
and straightaways. 


[52,20]PACE .TXT? <Ctrl/2Z> 
$ 


/SELECT=SIZE=n 

/SELECT=SIZE=MINIMUM=n 
/SELECT=SIZE=MAXIMUM=n 
/SELECT=SIZE=(MINIMUM=m,MAXIMUM=n) 

Selects files based on their size. The specified size can be: 


n Selects only those files with size equal to n. 

MINIMUM=n Selects only those files with size greater than or 
equal to n. 

MAXIMUM=n Selects only those files with size less than or 
equal to n. 

MINIMUM=m,MAXIMUM=n Selects only those files with size between m and n 
inclusive. 
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3.3 Deleting Files: DELETE 


Format 


The DELETE command permanently removes a file from a directory. 


DELETE file-specy,...] 


Command Qualifiers 

/BEFORE=date 

/[NO]JCONFIRM 

/CREATED 

/ERASE 

/[NO]LOG (N) 

/MODIFIED 

/[NOJQUERY (N) 

/SELECT=SIZE=n 
=MINIMUM=n 
=MAXIMUM=n 


=(MINIMUM=m,MAXIMUM=n) 


/SINCE=date 
/[NOJ]WARNINGS 


Prompts 
Files: file-specf,...] 


Defaults 

none 
/NOCONFIRM 
none 

none 

/LOG 

none 
/NOQUERY 
See discussion 


none 
/WARNINGS 


For example, if you want to delete the file BETH.DAT, type: 


S DELETE BETH.DAT <RET> 


Command Parameters 
file-spec{,...] 


Specifies the name of one or more files to be deleted. If your installation has 
DECnet/E, you can specify the node where the files are located. 


Each file specification must contain a file name and a file type. You can specify 
wildcard characters for the directory, file name, or file type. For example: 


S DELETE DB2:RACE.* <RET> 


To delete more than one file, separate the file specifications with commas (,) or 
plus signs (+). If you omit the account specification or device name, RSTS/E uses 
your directory and the system disk. For example: 


S$ DELETE ROAD.MAP,*.TXT+STRIDE.* <RET> 


WORKING WITH FILES 3-19 


Command Qualifiers 


/BEFORE=date 

Specifies that only the files dated earlier than a particular date be deleted. The 
/BEFORE qualifier is useful only when you include wildcard characters in the file 
specification. 


Use the /CREATED or /MODIFIED qualifiers in conjunction with /BEFORE to 
request that RSTS/E delete only files created or modified before the specified date. 


For example, suppose you have files named RESULT.A, RESULT:B, and 
RESULT.C in your directory, and you created file RESULT.C today. To delete 
the files created before today, type: 


S$ DELETE/BEFORE=TODAY RESULT.* <RET> 
RESULT.A deleted 
RESULT.B deleted 


You can use /BEFORE only when deleting files on the local (your own) node. 
/CONFIRM 
/NOCONFIRM 


Displays each file specification and asks if you want to delete that file. 
/CONFIRM is synonymous with /QUERY. The default is /NOCONFIRM. 


/CREATED 
Specifies that only files created within a defined time period be deleted. Use the 
/CREATED qualifier with either the /BEFORE or /SINCE qualifiers. 


For example, if you do not want to save any of the files you created today, type: 
$ DELETE/CREATED/SINCE=TODAY <RET> 


You can use /CREATED only when deleting files on the local (your own) node. 


/ERASE 
Specifies that you want to zero the file prior to deleting it. This qualifier is useful 
if you want to erase a file for security purposes. 


For example, to erase the file JIM.LOG, type: 


S DELETE/ERASE JIM.LOG <RET> 
JIM.LOG erased and deleted 


/LOG 

/NOLOG 

Controls whether the DELETE command displays the file specification of each file 
after its deletion. 


The default is /LOG; normally the DELETE command displays the names of files 
after it deletes them. For example: 


S$ DELETE RISTUS.ONE <RET> 
RISTUS.ONE deleted 


You can request the deletion message explicitly with /LOG: 


S DELETE/LOG PETER.WRK <RET> 
PETER .WRK deleted 


Note that the /NOLOG qualifier suppresses the usual message: 


$ DELETE/NOLOG ROAD.MAP <RET> 
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/MODIFIED 
Specifies that only files modified within a defined time period be deleted. Use the 
/MODIFIED qualifier with either the /BEFORE or /SINCE qualifiers. 


For example, if you want to delete all files that have not been modified since June 
11, type: 

$ DELETE/MODIFIED/BEFORE=11-JUN <RET> 

A file’s revision date is updated whenever the file is modified. (Your system 


manager may have changed this, so that the date is updated whenever the file is 
read or modified.) 


You can use /MODIFIED only when deleting files on the local (your own) node. 


/QUERY 

/NOQUERY 

Specifies that you want to select files to be deleted. Use the /QUERY qualifier 
when you use a wildcard in the command line, so you can avoid deleting files 
unintentionally. The default is /NOQUERY. 


For example, suppose you want to delete some of your files with a .DAT file type. 
The command line is: 


$ DELETE *.DAT/QUERY <RET> 


DCL prints a file specification followed by a question mark (?) prompt. You can 
reply by typing one of the following responses: 


Y Yes, delete the file 

N No, do not delete the file 
<RET> No, do not delete the file 
<Ctrl/Z> Quit; return to command level 


The display at your terminal looks similar to: 


[52,20]WRITE .DAT? N <RET> 
[52,20]MANUAL.DAT? Y <RET> 
MANUAL.DAT deleted 

[52,20] PACE .DAT? <Ctrl/Z> 
$ 

/SELECT=SIZE=n 
/SELECT=SIZE=MINIMUMe=en 
/SELECT=SIZE=MAXIMUM=n 


/SELECT=SIZE=(MINIMUM=m,MAXIMUM=n) 
Selects files based on their size. The specified size can be: 


n Selects only those files with size equal to n. 

MINIMUM=en Selects only those files with size greater than or 
equal to n. 

MAXIMUM=n Selects only those files with size less than or 
equal to n. 

MINIMUM=m,MAXIMUM=n Selects only those files with size between m and n 
inclusive. 

/SINCE=date 


Specifies that only the files dated on or after a particular date be deleted. 


A file is implicitly modified on the date it was created. Therefore, a file’s date of 
modification never exceeds its date of creation. 
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Use the /CREATED or /MODIFIED qualifier to request that only files created or 
modified on or after the specified date be deleted. If you do not specify /CREATED 
or /MODIFIED, the DELETE command deletes all files created since the specified 
date. 


For example, the following command line deletes all files created on or after June 
11: 


Ld is wb dba Sek fo et ote LYN De 


To delete all files named RACE that were modified since April 6, type: 
$ DELETE/MODIFIED/SINCE=06-APR RACE.* <RET> 


You can use /SINCE only when deleting files on the local (your own) node. 
/WARNINGS 
/NOWARNINGS 


Displays an error message if the specified files are not found. The default is 
/WARNINGS. 
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3.4 Copying, Renaming, and Appending Files 


This section describes commands that let you copy, rename, and append the 
contents of files. 


3.4.1 COPY 


The COPY command duplicates one or more existing files, or concatenates two or 
more files. You can use this command for local and network file specifications. 


Use COPY to: 

e Copy one file to another file 

e Merge more than one file into a single file 

e Copy a group of files to another group of files 

For example, if you have a file named SMITH.MAR and you want to make a copy 
of it as file JONES.JOE, you type: 

$ COPY SMITH.MAR JONES.JOE <RET> 


The following command copies all of your files on the public structure (SY:) to a 
tape (MT0:). (If the tape is in DOS format, the files are copied to your PPN on 
the tape.) For example: 


S COPY SY:*.* MTO: <RET> 


To copy every file on a tape (MT0:) into your directory on the public structure 
(SY:), type: 


$ COPY MTO:[*,*]*.* *.* <RET> 


If you copy files from ANSI tape to disk, you do not need to include the [*,*] 
directory specification. (ANSI format tapes do not have directories.) 


When you specify more than one input file and a single output file, the COPY 
command merges all the input files into the output file: 


$ COPY RABBIT.1,RABBIT.2,RABBIT.3 BUNNY.ALL <RET> 


The example merges a copy of files RABBIT.1, RABBIT.2, and RABBIT.3 into one 
file named BUNNY.ALL. 


If you specify more than one input file and give an output file specification that 
contains a wildcard character, the COPY command creates one output file for 
each input file: 


$ COPY HARE.1,HARE.2,HARE.3 BIGFUT.* <RET> 


The example copies files HARE.1, HARE.2, and HARE.3 into files named 
BIGFUT.1, BIGFUT:2, and BIGFUT.3, respectively. 


Similarly, the following example copies all files named ONE into files named 
TWO, with the same file types: 


$ COPY ONE.* TWO.* <RET> 
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Format 


You can specify multiple input files in any of the following ways: 


e Separate input file specifications with commas (,) or plus signs (+). For 


example: 


$ COPY ROAD.LST,RACE.DAT,ENTRY.LST RESULT.MRG <RET> 


The input files ROAD.LST, RACE.DAT, and ENTRY.LST are copied in that 
order into an output file named RESULT.MRG. 


e Specify wildcard characters in place of the directory specification, file name, 
or file type of an input file specification. The following example copies all 
COBOL source files on D:[160,*] to the public structure: 


$ COPY D:[160,*]*.CBL SY:*.* <RET> 


The expression D:[160,*] means all directories on disk D: with project number 
160. For example, directories D:[160,5],D:[160,25], and D:[160,39]. All 
COBOL source files (*.CBL) on D:[160,*] are copied to the public structure 
(SY:) into files of the same name and type. You must have access to each of 


these files to use this command string. 


The COPY command creates multiple output files when you specify multiple 


input files and do one of the following: 


¢ Include asterisk wildcard characters (*) in the output directory specification, 


file name, or file type fields. For example: 


$ COPY RACE1.*,ROAD.MAP DB1:*.* <RET> 


¢ Omit the output file name, or omit the file type and its preceding period 
(either of which is equivalent to specifying a wildcard). 


When you specify a wildcard for any part of the output file specification, the 
COPY command uses the corresponding part of the input file specification. 


COPY [node::]input-file-specf,...] | [node::Joutput-file-spec 


Command Qualifiers 
/ALLOCATION=n 
/BEFORE=date 
/BLOCK_SIZE=n 
/CLUSTER_SIZE=n 
/[NO]CONFIRM 
/CREATED 
/[NO]JCONTIGUOUS (N) 
/[NO]LOG (N) 
/MODIFIED 
/[NOJOVERLAY 
/POSITION[=n] 
[=MIDDLE}] 
[=INDEX] 
/PROTECTION=n 
/[NOJQUERY (N) 
/[NO]REPLACE (N) 
/[NO]JRETAIN_ DATES 
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Defaults 

none 

none 
/BLOCK_SIZE=512 
none 
/NOCONFIRM 
none 

See discussion 
/LOG 

none 
/NOOVERLAY 
/POSITION=0 


none 

/NOQUERY 

See discussion 
/NORETAIN DATES 


/SELECT=SIZE=n See discussion 
=MINIMUM=n 
=MAXIMUM=n 
=(MINIMUM=m,MAXIMUM=n) 
/SINCE=date none 
/TRANSFER_MODE=n /TRANSFER_MODE=AUTOMATIC 
=BLOCK 
=RECORD 


Prompts 

From: input-file-spec{,...] 

To: output-file-spec 

OK to replace existing file file-spec ? 


Command Parameters 


input-file-spec{....] 

Specifies one or more input files to be copied. If you specify more than one input 
file, separate them with either commas (,) or plus signs (+). You can use wildcard 
characters for the directory, file name, or file type. 


The following example uses wildcards and commas: 


S$ COPY *.TXT,RACE.1,RACE.2 FINISH.TXT <RET> 


This command line copies all files with the type .TXT, and files RACE.1 and 
RACE.2 into a file named FINISH.TXT. 


output-file-spec 
Specifies the name of the file into which the input files are to be copied. 


You must specify at least one part of the output file specification. 


If you do not specify a device or directory, the COPY command uses the public 
structure and your own directory. For other parts that you do not specify, the 
COPY command uses the corresponding field of the input file specification. 


If you specify an asterisk wildcard character (*) in place of the file name or file 
type of the output file specification, the COPY command creates one or more 
output files, based on the input file specification. It uses the corresponding part 
of the input file specification to name the output file. 


For example, assume you have files NAME.1, NAME.2, and NAME.3 in your 
directory. To copy these files into duplicates named NEW.1, NEW.2, and NEW.3, 


you type: 
S$ COPY NAME.* NEW.* <RET> 


You can use wildcard characters in the directory specification of an output file. 
For example, the following command copies all files in all directories on the public 
structure onto DB1:, into the corresponding directory, file names, and file types: 


S COPY [*,*]*.* DBl:[*,*] 


The preceding command line copies all files in all directories onto a disk named 
DB1:. The file names remain the same because you do not specify an output file 
name. 
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The ability to copy files depends on the file protection codes and whether or not 
you have write access to the directory to which you are copying them. 


Command Qualifiers 


/ALLOCATION=n 

Creates space on the disk by forcing the initial allocation of the output file to 
a number of 512-byte blocks, which you specify with n. The following example 
provides three blocks of space to copy the file PAPER.NUM into SUPPLY.DAT: 


S COPY PAPER.NUM SUPPLY.DAT/ALLOCATION=3 <RET> 


If you do not specify the initial allocation of the output file, then RSTS/E 
determines it by the size of the input file being copied. 


You can use /ALLOCATION only if the input and output files are on the local 
(your own) node. 


/BEFORE=date 

/SINCE=date 

/CREATED 

/MODIFIED 

Copies files created or modified before or since the specified date. See Chapter 2 
for information on specifying dates and times. 


The following example copies all data files created before 01-Jun-90 into a file 
named OLDWRK.DAT: 


$ COPY/CREATED/BEFORE=01-Jun-90 *.DAT OLDWRK.DAT <RET> 


The following example copies all files that were modified today into a file named 
NUWORK.WED: 


$ COPY/MODIFIED/SINCE=TODAY *.* NUWORK.WED <RET> 
/BLOCK_SIZE=n 

Lets you specify a block size for output to magnetic tape. For example: 
$ COPY MYFILE.TXT MMO:MYFILE.TXT/BLOCK SIZE=2048 


The argument of the /BLOCK_SIZE=n qualifier must be an even integer in the 
range of 18 to 4096 bytes. The default is 512 bytes. 


If you are copying a large file, a larger block size can be useful because it reduces 
the number of interblock gaps that are needed; therefore, you can fit more data 
onto a tape. On the other hand, a small block size is often preferable for a small 
file, since it reduces the amount of space wasted at the end of the file. 


If you specify an invalid value for n, the COPY command prints the error message 
?Bad block size. 


The /BLOCK_SIZE=n qualifier has the following restrictions: 
e The qualifier can be used only for magnetic tape. Its use on disk is ignored. 


e The qualifier applies only to output files. The COPY command automatically 
handles input magnetic tape files with block sizes other than 512 bytes. 


e If the output tape is in ANSI format and is intended for interchange with 
another operating system, the block size must be an even integer between 18 
and 2048 bytes. Tapes having block sizes greater than 2048 bytes cannot be 
read by other operating systems. 


e If the output tape is intended for use on the RT-11 operating system, the 
block size must be 512 bytes. 
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If both the input and output files are on magnetic tape, and both have large block 
sizes, the COPY command may fail because of insufficient buffer space. If this 
happens, transfer the file to disk, and then use the COPY command to transfer 
the file from disk to tape. 


/CLUSTER_SIZE=n 

Establishes the cluster size for a disk file. A cluster size is a number of contigu- 
ous blocks taken together as a unit. The cluster size is the minimum unit of 
allocation for the file. 


This qualifier is especially useful for large files because specifying a large cluster 
size speeds random access to the data. 


In addition, you can avoid filling up your directory by specifying a large cluster 
size. (In your directory, the system maintains an internal list of the clusters in 
each file. If your directory fills up, you will receive the error message ?No room 
for user on device, even though the disk is not full.) 


RSTS/E allows cluster sizes of 1, 2, 4, 8, 16, 32, 64, 128, and 256 blocks. With 
the SHOW DISK command, you can display the minimum cluster size of each 
disk. If you specify a cluster size below the minimum, the system uses the disk’s 
minimum and does not display an error message. 


/CONFIRM 

/NOCONFIRM 

Indicates whether or not the system asks for confirmation before copying each 
file. This qualifier is synonymous with /QUERY. The default is /NOCONFIRM. 


/CONTIGUOUS 

/NOCONTIGUOUS 

Indicates whether or not the output file is to be contiguous. A contiguous file 
occupies consecutive logical disk blocks. 


For example, the following command line causes the file MANUAL.RUN to be 
stored in consecutive blocks on disk DB2:. 


§ COPY MANUAL.RUN DB2:*.*/CONTIGUOUS <RET> 


By default, the COPY command creates an output file in the same format as 

the corresponding input file. If an input file is contiguous, the COPY command 
attempts to create a contiguous output file. If there is not enough contiguous disk 
space, the system copies the file into available empty disk blocks and displays the 
message: | 


sFile file-spec created noncontiguous 
The /CONTIGUOUS qualifier should not be used if the output file is not on disk. 


If you are concatenating several input files, or if the single input file is on a 
device other than disk, and you are creating a contiguous output file, you must 
use the /ALLOCATION qualifier to preallocate the size of the output file. This 
is necessary because the system cannot judge the size of the output file in these 
cases. 


If you do not specify an allocation, or if the allocation is too small, RSTS/E 
displays the following error message when the system tries to increase the size of 
the contiguous output file: 


?Protection violation 


If you copy a file from a tape and want the file to be contiguous, you can use two 
COPY commands: one to copy the file from the tape, and another to create a 
contiguous file. 
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For example, assume you want to copy file FRIDAY.WOW from tape MT0: toa 
contiguous file in your account ([52,20]) on the public structure. You rename the 
file to WORK.END temporarily, because you cannot copy file FRIDAY.WOW to 
itself when making it contiguous: 


S$ COPY MTO:FRIDAY.WOW SY: [52,20]WORK.END/LOG <RET> 
[File FRIDAY.WOW copied to SY: [52,20]WORK.END] 


$ COPY WORK.END FRIDAY.WOW/CONTIGUOUS/LOG <RET> 
[File SY: [52,20]WORK.END copied to SY: [52,20]FRIDAY.WOW] 


$ DELETE WORK.END/LOG <RET> 
WORK.END Deleted 


The first command copies file FRIDAY.WOW from tape MTO0: into a file named 
WORK.END in your account ([52,20]) on the public structure. The second 
command copies WORK.END to a contiguous file named FRIDAY.WOW. The 
third command deletes the file WORK.END, because you used it only to move 
file FRIDAY.WOW into your account as a contiguous file. (Note that the /LOG 
qualifier displays each completed file operation.) 


If you specify /CONTIGUOUS and there is not enough contiguous disk space, the 
file is not contiguous and the system prints the error message: 


2?No room for user on device 


If you specified a network node name on either the input or output file, a different 
error message displays: 


?Device full: Can’t create or extend file 


/LOG 

/NOLOG 

Controls whether the COPY command displays the file specifications of each file 
copied. /LOG is the default. 


Unless you specify /NOLOG, the COPY command displays the file specifications 
of the input and output files. For example: 


$ COPY DR3:[52,20]CREATE.BAS [1,248]*.* <RET> 
[File DR3:[52,20]CREATE.BAS copied to [1,248]CREATE.BAS] 


/OVERLAY 

/NOOVERLAY 

Requests that data in the input file be copied into an existing output file, 
replacing the output file’s existing data. The physical location of the file on disk 
does not change. 


For example, assume you rewrote the first chapter (CHAP1.TXT) of a manual 
(MANUAL.RUN). To overlay the existing chapter with the new first chapter, type: 


$ COPY CHAP1.TXT MANUAL.RUN/OVERLAY <RET> 


If the input file is smaller than the output file, the excess data in the output file 
is not removed. In such a case (unless you use the /NOLOG qualifier), the COPY 
command prints a message similar to the following: 


[File CHAP1.TXT copied into prefix of [1,248] MANUAL.RUN] 


The default is /NOOVERLAY. In addition, RSTS/E ignores the /OVERLAY 
qualifier if the output file is written to any device other than a disk. 


You can use this qualifier only when the input and output files are on the local 
(your own) node. 
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/POSITION=n 

/POSITION=MIDDLE 

/POSITION=INDEX 

Specifies the starting position of the target file on disk. This qualifier is ignored 
for files copied on devices other than disks. 


If you specify /POSITION with an argument, then that value indicates the 
starting disk cluster at which to copy the file. The minimum value is 0 (beginning 
of disk) and the maximum value is the disk’s maximum cluster number. If you 
specify 0 (the default), the file is copied at the first available cluster on the disk. 


If you specify /POSITION=MIDDLE, the file is copied to the first available cluster 
past the middle of the disk. 


If you specify /POSITION=INDEX, the file is copied to the first available cluster 
following the storage allocation table (SATT.SYS) on the disk. 


/PROTECTION=n 
Specifies the protection code of the output file. 


You cannot use /PROTECTION with /OVERLAY, or in network operations. 


By default, RSTS/E assigns files a protection code of 60, unless your sys- 

tem manager changes the default. Furthermore, if you use the SET 
PROTECTION/DEFAULT command before the COPY operation, the protection 
code becomes the value you specified as the default. See the SET PROTECTION 
command description at the end of this chapter. 


You can use /PROTECTION only if the input and output files are on the local 
(your own) node. 

/QUERY 

/NOQUERY 


Lets you select files to be copied when you specify more than one file. The 
/QUERY qualifier is useful only if you use wildcards. The default is /NOQUERY. 


When you use /QUERY, RSTS/E displays each input file name and a question 
mark prompt. Enter one of the following responses after each prompt: 


Y Yes, copy the file 

N No, do not copy the file 

<RET> No, do not copy the file 

<Ctrl/Z> Skip remaining files; return to command level 


For example, if you have files STRIDE.TXT, RACE.TXT, and FINISH.TXT in your 
account, you can use the /QUERY qualifier as follows: 


$ COPY *.TXT MANUAL.RUN/NOOVERLAY/QUERY <RET> 
STRIDE.TXT? Y <RET> 

File STRIDE.TXT copied to MANUAL.RUN 

RACE .TXT? N <RET> 

FINISH.TXT? <Ctr1/Z> 

S 
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/REPLACE 
/NOREPLACE 


The /REPLACE qualifier requests that if a file already exists with the same file 
specification as the one you are creating, the existing file is to be deleted. 


For example, if there is a file named ROAD.MAP in your default directory, and 
you want the file you are copying to replace the existing file, type: 


S$ COPY ROAD.MAP/REPLACE <RET> 


If the COPY command is going to replace an existing file, but you do not specify 
/REPLACE or /NOREPLACE, RSTS/E displays the prompt: 


OK to replace existing filespec ? 


You can reply with one of the following: 


Y Yes, replace the file 
N No, do not replace the file 
<RET> No, do not replace the file 


A YES response allows you to copy the file and replace the existing file. 
Otherwise, the system returns to command level. 


For example, suppose you mistakenly enter the name of an existing file that you 
do not want replaced. The display at the terminal reads: 


S COPY FOO.TXT SORE.FUT <RET> 
OK to replace existing file DR1:[52,20]SORE.FUT? N <RET> 


The /NOREPLACE qualifier forces the COPY command to fail if the file being 
created already exists. In addition, it suppresses the "OK to replace existing 
filespec?" prompt. 


If you use the COPY command in a command procedure, you should explicitly 
specify either /REPLACE or /NOREPLACE. This prevents DCL from issuing the 
"OK to replace existing filespec?" prompt. 


/RETAIN DATES 

/NORETAIN_DATES 

For disk output, the /RETAIN_DATES qualifier retains the creation date-time 
and access date of the input file. 


The /NORETAIN_DATES qualifier does not retain the input file’s creation date- 
time and access date. The output file is created with the current date-time. The 
default is /NORETAIN_DATES. 


/SELECT=SIZE=n 

/SELECT=SIZE=MINIMUM=n 
/SELECT=SIZE=MAXIMUM=n 
/SELECT=SIZE=(MINIMUM=m,MAXIMUM=n) 

Selects files based on their size. The specified size can be: 


n Selects only those files with size equal to n. 

MINIMUM=n Selects only those files with size greater than or 
equal to n. 

MAXIMUM=en Selects only those files with size less than or 
equal to n. 

MINIMU M=m,MAXIMUM=n Selects only those files with size between m and n 
inclusive. 
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/TRANSFER_MODE=n 

/TRANSFER_MODE=AUTOMATIC 

/TRANSFER_MODE=BLOCK 

/TRANSFER_MODE=RECORD 

Used on the input filespec to select the method by which the file(s) are transferred 
to or from a remote node. The default is /TRANSFER_MODE=AUTOMATIC. 


/TRANSFER_MODE=BLOCK causes the file to be transferred as binary data 
consisting of 512-byte blocks. This mode of transfer is generally faster than 
record mode. However, it is only applicable for RSTS-to-RSTS file transfers, since 
other operating systems may not have compatible file attributes and blocksizes. 


/TRANSFER_MODE=RECORD copies the file as a collection of records based on 
the file record format. This mode of transfer is generally slower than block mode. 
However, records are a common medium of exchange for otherwise incompatible 
file systems. This mode is recommended for file transfers involving TOPS10/20, 
ULTRIX, RT-11 and DECnet-DOS systems. 


If /TRANSFER_MODE=AUTOMATIC is specified, then the most suitable mode of 
transfer will automatically be selected. 
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3.4.2 RENAME 


Format 


The RENAME command changes the file name or type of an existing file. 


RENAME _ old-file-specf,...] new-file-spec 
Command Qualifiers Defaults 
/BEFORE=date none 
/[NO]JCONFIRM /INOCONFIRM 
/CREATED none 
/[NO]LOG /LOG 
/MODIFIED none 
/PROTECTION=n See discussion 
/[NOJQUERY /NOQUERY 
/[NO]JREPLACE /NOREPLACE 
/SELECT=SIZE=n See discussion 

=MINIMUM=n 

=MAXIMUM=n 

=(MINIMUM=m,MAXIMUM=n) 
/SINCE=date none 
/[NOJWARNINGS WARNINGS 
Prompts 
From: old-file-specj,...] 
To: new-file-spec 


For example, you can rename the file JIM.DAT to JOHN.DAT with the command 
line: 


S$ RENAME JIM.DAT JOHN.DAT <RET> 


Command Parameters 


old-file-spec[,...] 
Specifies one or more files whose specifications you want to change. The files 
must be stored on a disk. 


You can use wildcard characters in the directory, file name, or file type of the file 
specification. If you use wildcards, all the files you specify are renamed (assuming 
that they are your own files or that you have additional privilege to rename other 
users’ files). 


new-file-spec 

Provides the new file name or type to be applied to the input file. The RENAME 
command uses the file name and type of the input file specification to provide 
defaults for fields you do not specify in the output file. (You cannot change the 
device or directory of the files.) 
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You can specify an asterisk (*) in place of the file name or type of the output 

file specification, or you can omit either one; the RENAME command uses the 
corresponding field in the input file specification to name the output file. The 
/QUERY qualifier is useful when you use RENAME with wildcards. 


Command Qualifiers 


/BEFORE=date 

/SINCE=date 

/CREATED 

/MODIFIED 

Renames files created or modified before or since the specified date. See 
Chapter 2 for information on specifying absolute date and time formats. 


The following example renames all files created before 01-Jun-90 with a file type 
of .TXT to files with a file type of .DAT: 


S$ RENAME/CREATED/BEFORE=01-JUN-90 *.TXT *.DAT <RET> 


The following example renames all files that were modified today to files with a 
file extension of .WED: 


S$ RENAME/MODIFIED/SINCE=TODAY *.* *.WED <RET> 


/CONFIRM 

/NOCONFIRM 

Prompts for confirmation before renaming files. This qualifier is synonymous 
with /QUERY. The default is /NOCONFIRM. 


/LOG 

/NOLOG 

When you rename a file, RSTS/E automatically displays a message to confirm 
that the file was renamed. You can also request this message explicitly with the 
/LOG qualifier, although /LOG is the default. The /NOLOG qualifier suppresses 
the message. For example: 


S RENAME RACE1.TXT FUN1.RUN <RET> 
RACE1.TXT renamed to FUN1.RUN 


S RENAME RACE2.TXT FUN2.RUN/LOG <RET> 
RACE2 .TXT renamed to FUN2.RUN 


S$ RENAME RACE3.TXT FUN3.RUN/NOLOG <RET> 


/PROTECTION=n 
Specifies the protection code to assign to the file to be renamed. By default, the 
protection codes of the files are not changed. 


/QUERY 

/NOQUERY 

Allows you to select which files you want to rename. The /QUERY qualifier is 
only useful when you use wildcards in the old file specification. The default is 
/NOQUERY. 
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When you use /QUERY, RSTS/E displays individual file names and a question 
mark prompt. You can reply with: 


Y Yes, rename the file 

N No, do not rename the file 

<RET> No, do not rename the file 

<Ctrl/Z> Skip remaining files; return to command level 

If the file exists and you do not specify /REPLACE, DCL displays the error 
message: 

?Name or account now exists - file file-spec - continuing 


For example, suppose you want to rename some of your files with a .TXT file type 
to files with a .DAT file type. You can enter the following command line and then 
answer the prompts as follows: 


S$ RENAME *.TXT *.DAT/QUERY <RET> 

[52,20]RACE1.TXT? Y <RET> 

RACE1.TXT renamed to RACE1.DAT 

[52,20] STRIDE.TXT? Y <RET> 

?Name or account now exists - file STRIDE.DAT - continuing 
[52,20]ATLAS.TXT? N <RET> 

[52,20] TEXT.TXT? <Ctr1/Z> 

$ 


/REPLACE 

/NOREPLACE 

Replaces any existing files with a file to which you assign the same name. The 
default is /NOREPLACE. The /NOREPLACE qualifier (whether by default or by 
inclusion) is useful when you know that you need all your files and do not want 
to risk replacing one. 


For example, assume you want to rename the file PAVED.DAT to TRACKS.DAT, 
and that you no longer need the existing file named TRACKS.DAT. The first of 
the following command lines assumes the /NOREPLACE qualifier, the second 
explicitly includes /NOREPLACE, and the third command line replaces the file: 


S$ RENAME PAVED.DAT TRACKS.DAT <RET> 
?Name or account now exists - file TRACKS.DAT - continuing 


S$ RENAME PAVED.DAT TRACKS.DAT/NOREPLACE <RET> 
?Name or account now exists - file TRACKS.DAT - continuing 


S RENAME PAVED.DAT TRACKS .DAT/REPLACE <RET> 
File PAVED.DAT renamed to TRACKS .DAT 
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/SELECT=SIZE=n 

/SELECT=SIZE=MINIMUM=n 
/SELECT=SIZE=MAXIMUM=n 
/SELECT=SIZE=(MINIMUM=m,MAXIMUM=n) 

Selects files based on their size. The specified size can be: 


n Selects only those files with size equal to n. 

MINIMUM=n Selects only those files with size greater than or 
equal to n. 

MAXIMUM=n Selects only those files with size less than or 
equal to n. 

MINIMUM=m,MAXIMUMe=n Selects only those files with size between m and n 
inclusive. 

/WARNINGS 


/NOWARNINGS 
Displays an error message if you try to rename a file to the same name as an 
existing file. The default is /(WARNINGS. 
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3.4.3 APPEND 


Format 


The APPEND command adds the contents of one or more files to the end of 
the file you specify. APPEND is similar in syntax and function to the COPY 
command. 


For example, assume you create two files and then decide to append the first file 
to the second one: 


S CREATE FILE.A <RET> 
This is File A. <RET> 


<Ctrl1/Z> 


$ CREATE FILE.B <RET> 
And this is File B. <RET> 


<Ctrl1/Z> 
The APPEND command puts the contents of FILE.A at the end of FILE.B: 


S$ APPEND FILE.A FILE.B <RET> 
[File FILE .A appended to [52,20]FILE .B] 


S TYPE FILE.B <RET> 
And this is File B. 
This is File A. 


FILE.B now includes a copy of FILE.A; the original FILE.A remains unchanged. 


Note that you cannot append a file to itself. If you try, RSTS/E displays an error 
message: 


S APPEND MOXIE.DAT MOXIE.DAT <RET> 
?Protection violation - file MOXIE .DAT 


APPEND __ input-file-spec[,...] output-file-spec 


Command Qualifiers Defaults 
/BEFORE=date none 
/[NO]CONFIRM /NOCONFIRM 
/CREATED none 
/[NO]LOG (N) /LOG 
/MODIFIED none 
/[NO]QUERY (N) /NOQUERY 
/SELECT=SIZE=n See discussion 

=MINIMUM=n 

=MAXIMUM=n 

=(MINIMUM=m,MAXIMUM=n) 
/SINCE=date none 
Prompts 


From: input-file-spec{,...] 
To: output-file-spec 
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Command Parameters 


input-file-spec[,...] 
Specifies one or more input files to append to the output file. If your installation 
has DECnet/E, you can specify the node where the input files are located. 


If you specify more than one input file, separate the file specifications with 
commas (,) or plus signs (+). All files are appended, in the order specified, to the 
end of the output file. 


You can use wildcards in any part of the file specification. For example, to 
combine files STRIDE.REP, STRIDE.COP, and STRIDE.TXT into an existing file 
named EVENT.DOC, you type: 


S APPEND STRIDE.* <RET> 

To: EVENT.DOC <RET> 

[File STRIDE.REP appended to [52,20]EVENT.DOC] 
[File STRIDE.COP appended to [52,20]JEVENT.DOC] 
[File STRIDE.TXT appended to [52,20]EVENT.DOC] 


output-file-spec 

Specifies the file to which the input files are to be appended. (The output file 
must be on a disk.) If your installation has DECnet/E, you can specify the node 
where the output file is located. 


If the output file does not exist, RSTS/E displays the following error messages: 


?Can’t find file or account - file output-file-spec - continuing 
[File input-file-spec copied to output-file-spec] 


RSTS/E then creates a new output file. 


You must specify at least one part of the output file specification. If you do not 
specify a device and/or directory, the APPEND command uses your directory on 
the public disk structure. For other fields that you do not specify, the APPEND 
command uses the corresponding field of the input file specification. 


If you specify the asterisk wildcard character (*) in any part of the output file 
specification, the APPEND command uses the corresponding field of the related 
input file specification. For example: 


$ APPEND ONE.* <RET> 

To: TWO.* <RET> 

[File ONE.TXT appended to [52,20]TWO.TXT] 
[File ONE.DAT appended to [52,20]TWO.DAT] 


Command Qualifiers 


/BEFORE=date 

/SINCE=date 

/CREATED 

/MODIFIED 

Appends files created or modified before or since the specified date. See Chapter 2 
for information on specifying dates and times. 


The following example appends all data files created before 01-Jun-90 to a file 
named OLDWRK.DAT: 


S$ APPEND/CREATED/BEFORE=01-Jun-90 *.DAT OLDWRK.DAT <RET> 
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The following example appends all files that were modified today to a file named 
NUWORK.WED: 


$ APPEND/MODIFIED/SINCE=TODAY *.* NUWORK.WED <RET> 


/CONFIRM 
/NOCONFIRM 


Requests confirmation before appending files. This qualifier is synonymous with 
/QUERY. The default is /NOCONFIRM. 


/LOG 

/NOLOG 

Controls whether the APPEND command displays the file specifications of each 
file appended. Unless you specify /NOLOG, the APPEND command displays the 
file specifications of the input and output files after each append operation. For 
example: 


S APPEND ATHENS.TXT OHIO.TXT/LOG <RET> 
[File ATHENS.TXT appended to [52,20]OHIO.TXT] 


$ APPEND ATHENS.TXT MASS.TXT <RET> 
[File ATHENS.TXT appended to [52,20]MASS .TXT] 


$ APPEND ATHENS.TXT MAINE.TXT/NOLOG <RET> 


/QUERY 

/NOQUERY 

Determines whether to append individual files to other files. The /QUERY 
qualifier is only useful when you use wildcards in the input file specification. The 
default is /NOQUERY. 


When you use the /QUERY qualifier, DCL displays a file name followed by a 
question mark prompt. You can reply with either: 


Y Yes, append the file 

N No, do not append the file 

<RET> No, do not append the file 

<Ctrl/Z> Skip remaining files; return to command level 


For example, suppose you want to append some of your files with the type .DAT 
to a file named RACES. TXT: 


$ APPEND *.DAT TO RACES.TXT/QUERY <RET> 
RACE1.DAT? Y 

[RACE1.DAT appended to [52,20]RACES.TXT] 
RACE2 .DAT? N <RET> 

RACE3 .DAT? <Ctr1/Z> 

S 


/SELECT=SIZE=n 

/SELECT=SIZE=MINIMUM=n 
/SELECT=SIZE=MAXIMUM=n 
/SELECT=SIZE=(MINIMUM=m,MAXIMUM=n) 

Selects files based on their size. The specified size can be: 


n Selects only those files with size equal to n. 

MINIMUMen Selects only those files with size greater than or equal to n. 
MAXIMUM=n Selects only those files with size less than or equal to n. 
MINIMUM=em, Selects only those files with size between m and n inclusive. 
MAXIMUM=n 
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3.5 Backing Up and Restoring Files 


The commands in this section let you copy the contents of your disk files to 
magnetic tape or to another disk then restore the same files back onto your 
system if necessary. Backing up files is a precautionary measure to let you 
recover from the loss or destruction of valuable information. Files created by 
BACKUP are called Backup sets. A Backup set is a RSTS/E file that can be 
copied just like any other RSTS/E file. However, only BACKUP and RESTORE 


can interpret the data in a Backup set. 


3.5.1 BACKUP 


Format 


The BACKUP command allows you to create a Backup set on a specified disk or 
magnetic tape from one or more RSTS/E disk files. 


BACKUP filespecf,...] backup-set 


Command Qualifiers 
/CREATED=(date:time) 
/MODIFIED=(date:time) 
/END=action 


/EXCLUDE=(filespec-list) 
/INCLUDE=(filespec-list) 
/[NOJINITIALIZE 

/IN LABEL=name 
/[NOJLIST_FILE[=filespec] 
/OUT_LABEL=name 
/[NOJOUTPUT[=filelspec] 
/[NO]JPROMPT 
/[NOJQUERY 
/[NOJREWIND 
/[NO]VERIFY[=ONLY] 


Prompts 
See Discussion 


Defaults 
See discussion 


/END=DISMOUNT for disks 
/END=NOREWIND for tapes 
No files excluded 

No files included 
/NOINITIALIZE 

Volume ID is not checked 
/LIST_FILE=KB: 

See discussion 
/OUTPUT=KB: 

/PROMPT 

/NOQUERY 

/NOREWIND 

/NOVERIFY 


Command Parameters 


filespecf,...] 

Identifies the files located on a disk to be backed up. The file specification should 
be a standard RSTS/E file specification or a list of specifications separated by the 
plus (+) sign or a comma (,): 
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If you do not specify device, the default is SY:. The PPN is optional and defaults 
to the user’s current account. You can use wildcards in the PPN. The file 
specification is optional and defaults to *.*. You can use standard wildcards. 

If you specify a filename but not the type, BACKUP assumes a * type. If the 
filename ends with a period, BACKUP assumes a null type. If you specify a file 
type, you must also specify a filename. 


backup-set 

Identifies the disk or tape where the Backup set is to be created. The Backup 
set specification should be a standard RSTS/E file specification. You must specify 
the device. PPN is optional and defaults to the user’s current account. The file 
specification is optional and defaults to BACKUP.BCK. 


Command Qualifiers 


/CREATED=(date:time) 

/MODIFIED=(date:time) 

The /CREATED and /MODIFIED qualifiers let you select the files to be backed 
up, as chosen by the file specification criteria (see the input-file-spec description), 
based on the creation date/time or revision date or both. If no file specification 
criteria exist, these qualifiers apply to all files on the input volume for this 
operation. You can use /CREATED and /MODIFIED in conjunction with each 
other; they are not mutually exclusive. To be selected, a file has to satisfy all the 
criteria you specify. 

The date-time argument is of the standard form (for example, dd-mmm-yy or 
yy.mm.dd and hh:mm AM or hh:mm PM). You must specify the date. If you do 
not specify the time, it defaults to 00:00. In addition, if you specify the time, you 
must separate it from the date by a colon (:). 


The following generic terms can be used in the subqualifier: 
e TODAY—meaning 00:00 on the current (system) date 
¢ YESTERDAY—meaning 00:00 on the date previous to the current date 


When used with /CREATED, the generic terms also accept a time argument. 


If you do not specify either /CREATED or /MODIFIED, BACKUP selects all 
specified files for transfer to the Backup set. 


NOTE 


Files transferred by BACKUP retain their original creation and 
revision dates (that is, the dates on the source volume). You need the 
DATES privilege to keep these original dates; otherwise, RSTS/E lists 
the current date as the creation date of the backed-up file. 


/END=action 
Specifies the disposition of the tape or disk drive at the end of the backup 
operation. 


For tapes, /END=[NOJREWIND specifies whether or not to rewind the output 
tape after the BACKUP operation is complete. The default is /END=REWIND, 
which leaves the tape positioned immediately after the backup set just written. 


For disks you can specify /END=[NO]DISMOUNT. The default is /END=DISMOUNT. 
/EXCLUDE=(filespec-list) 
Lets you specify files that you want excluded from the BACKUP operation (for 


example, [0,1JSWAP?.SYS). You can include a list of file specifications in the 
command line up to the maximum length of a DCL command line. 
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The default is that no files are excluded. 


/INCLUDE=(filespec-list) 

Lets you specify files or accounts that you want to be unconditionally pro- 
cessed. You can include a list of file specifications in the command line up to the 
maximum length of a DCL command line. 


Files in this set override those excluded with the /EXCLUDE qualifier. 


/[NO]JINITIALIZE 

Specifies the disposition of the output media prior to the data transfer operation 
and sets the default device specification in the "Where can this volume be located 
<default>?" prompt. 


For disk volumes, /INITIALIZE specifies that any file structure on the disk is to 
be disregarded and the volume is to be reinitialized with a RSTS/E file structure 
as if it were done with the INITIALIZE command. 


For magnetic tape volumes, /INITIALIZE specifies that BACKUP initializes the 
tape as a standard ANSI tape. 


IN _LABEL=name 

Specifies the name to be compared to the source volume ID. If you use this 
qualifier, the source volume ID must equal the specified name before BACKUP 
can perform the requested operation. 


[LIST 

/NOLIST_FILE[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the BACKUP operation. The file specification can be any valid 
RSTS/E file specification (wildcards are not allowed). 


The default is your terminal (KB:). 


You can use this qualifier to produce a listing of files in the Backup set. 


/OUT_LABEL=name 
Specifies the desired name for the output volume ID. The resultant name can 
vary depending on the interaction between /OUT_LABEL and /[NO]JINITIALIZE. 


Table 3—2 lists the possible outcome from the interaction of /[NOJINITIALIZE and 
/OUT_LABEL during BACKUP. 


Table 3-2: /INITIALIZE and /OUT_LABEL Interaction During BACKUP 


Qualifiers 

Specified Output Volume ID 

/OUT_LABEL=name The Specified name. 

/JINITIALIZE 

/OUT_LABEL=name The specified name; however, the operation is only successful if 
/NOINITIALIZE the output volume label has the same name. 

/JINITIALIZE (only) BACKUP supplies the name "BACKUP". 


/NOINITIALIZE (only) The name is unchanged. 
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/OUTPUT 

/NOOUTPUT[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the BACKUP operation. The file specification can be any valid 
RSTS/E file specification (wildcards are not allowed). You can use this qualifier 
to produce a listing of files in the Backup set. /NOOUTPUT is a synonym for 
/NOLIST_FILE. 


The default is your terminal (KB:). 


/[NO]PROMPT 

Normally, the Backup utility issues a MOUNT prompt, for each BACKUP 
operation even if the Backup set’s device is already mounted. You can eliminate 
the prompt for the first volume by including the /NOPROMPT qualifier in your 
command line. 


The default is /PROMPT. 


/[NOJQUERY 

Causes BACKUP to prompt you for each file that meets the selection criteria as 
to whether or not the file should be transferred. A Y[ES] response effects the 
transfer. A response of N[O] or pressing Return bypasses the file. Any other 
response causes the prompt to be reissued. 


A YES/ALL response causes the current file and all remaining files to be trans- 
ferred without any further prompting. A response of NO/ALL causes the current 
file and all remaining files to be bypassed without any further prompting. 


The default is /NOQUERY. 


/[NO]JREWIND 
For tape backup files, indicates whether to rewind the tape before searching for 
the logical end of tape to create the backup file. 


BACKUP must locate the logical end of tape so that it can create the backup file 
after any files already on the tape. While searching for the end of tape, BACKUP 
will check the name of each file it encounters and report an error if it finds a file 
with the same name as the backup file. This prevents having two files with the 
same name on the tape. 


If you specify /REWIND, BACKUP rewinds the tape and scans the entire tape for 
a duplicate file. 


If you specify /NOREWIND, BACKUP scans from the tape’s current position, and 
will not detect duplicate files located earlier on the tape. 


The default is /NOREWIND. 
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/[NO]VERIFY[=ONLY] 

The /VERIFY qualifier specifies that a comparison operation is to be performed 
on all data transferred. This postprocess verification reports the presence of 

any data difference. For any differences found, BACKUP displays the PPN, file 
name, and file type at your terminal. /VERIFY=ONLY causes the verify only pass 
to be made over the same input and output specifications used for the backup 
pass. You can use /VERIFY=ONLY to compare the contents of a backup set with 
the source disk to determine what files have changed since the backup set was 
created. You can also use this qualifier to verify several backup sets on one tape 
without having to wait for the tape to rewind after each backup set. 


The default is /NOVERIFY. 


Examples 


BACKUP DR1:PAYROL.DAT MTO:PAYROL.BCK 


This command saves a file to a save set on tape 


BACKUP DR2:PAYROL.DAT,DR2:BENEFI.DAT,DR2:VACATI.DAT MTO:DAT17M.BCK 


This command saves a list of files to a save set on tape 
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3.5.2 BACKUP/DIRECTORY 


The BACKUP/DIRECTORY command allows you to list files contained in an 
existing backup saveset. BACKUP/DIRECTORY prompts with: 


Format 


Please mount volume 1 of Backup set backup-set-name 
Where can this volume be located <default>? 


At the prompt, enter the device name where the saveset is located. The default is 
the output device you specified in the BACKUP/DIRECTORY command line. 


BACKUP/DIRECTORY  backup-set 


Command Qualifiers 
/BRIEF 
/CREATED=date:time 
/MODIFIED=date:time 
END=action 


/EXCLUDE=(filespec-list) 
/FULL 
/INCLUDE=(filespec-list) 
/IN _ LABEL=name 
/[NO]LIST_FILE[=filespec] 
/OCCURRENCE=number 
/[NOJOUTPUT [=filespec] 
/[NO]PROMPT 
/[NOJREWIND 
SELECT=(filespec-list) 


Command Parameters 


backup-set 


Defaults 

/BRIEF 

See discussion 

See discussion 
/END=DISMOUNT for disks 
/END=NOREWIND for tapes 
No files excluded 

/BRIEF 

No files included 

Volume ID is not checked 
your terminal 

First occurrence 

your terminal 

/PROMPT 

/NOREWIND 

All files 


Identifies the Backup set for which you want to obtain a directory listing. The 
Backup set specification should be a standard RSTS/E device specification. The 
default device is SY:, the default PPN is your current account and the default file 


type is .BCK. 


Command Qualifiers 


/BRIEF 


If you specify this qualifier, a format similar to the DCL full directory (minus file 


attributes) is displayed. 
The default is /BRIEF. 
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/CREATED=(date:time) 

/MODIFIED=(date:time) 

The /CREATED and /MODIFIED qualifiers let you select the files included in 
the directory listing, as chosen by the file specification criteria, based on the 
creation date/time, revision date, or both. If no file specification criteria exist, 
these qualifiers apply to all files on the volume for this operation. You can 

use /CREATED and /MODIFIED in conjunction with each other; they are not 
mutually exclusive. To be selected, a file has to satisfy all the criteria you specify. 


You can specify an exact date or range of dates for either qualifier. In the range 
format, each qualifier must take an argument of one or both of the subqualifiers 
BEFORE or AFTER. The subqualifier order in the argument is immaterial. 


The date-time argument is of the standard form (for example, dd-mmm-yy or 
yy.mm.dd and hh:mm A/PM or hh:mm). You must specify the date. If you do not 
specify the time, it defaults to 00:00. In addition, if you specify the time, you 
must separate it from the date by a colon(:). The following generic terms can be 
used in the subqualifier: 


e TODAY—meaning 00:00 on the current (system) date 
° YESTERDAY—meaning 00:00 on the date previous to the current date 


When used with /CREATED, the generic terms also accept a time argument. If 
you do not specify either /CREATED or /MODIFIED, BACKUP/DIRECTORY lists 
all specified files. 


NOTE 


Files transferred during the backup operation retain their original 
creation and revision dates (that is, the dates on the source volume). 
You need the DATES privilege to keep these original dates; otherwise, 
RSTS/E lists the current date as the creation date of the backed-up file. 


/END=action 

Specifies the disposition of the tape or disk drive at the end of the directory 
listing operation. 

For tapes you can specify /[NOJREWIND. /REWIND rewinds the tape at the end 
of the directory listing operation. 


For disks you can specify ([NOJDISMOUNT. The default is /DISMOUNT, which 
logically dismounts the disk drive at the end of the directory listing operation. 


EXCLUDE=(filespec-list) 

This qualifier lets you specify files that you want excluded from the 
BACKUP/DIRECTORY operation (for example, [0,1JSWAP?.SYS). You can in- 
clude a list of file specifications in the command line up to the maximum length 
of a DCL command line. 


The default is that no files are excluded. 
/FULL 


If you specify this qualifier, detailed information for each file on multiple lines is 
displayed. 


To display information for specific files use /SELECT or /EXCLUDE with 
BACKUP/DIRECTORY. 
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/INCLUDE=(filespec-list) 

This qualifier lets you specify files or accounts that you want to be unconditionally 
listed. You can include a list of file specifications in the command line up to the 
maximum length of a DCL command line. 


/IN_LABEL=name 

This qualifier specifies the name to be compared to the source volume ID. If you 
use this qualifier, the source volume ID must equal the specified name before 
BACKUP/DIRECTORY can perform the requested operation. 


/[NO]LIST_FILE[=filespec] 

This qualifier controls the production of a directory-like listing file that cat- 
alogues the sequence of events in the BACKUP/DIRECTORY operation. The 
file specification can be any valid RSTS/E file specification (wildcards are not 
allowed). 


You can use this qualifier to produce a listing of files in the Backup set. 


The default is your terminal (KB:). 


/OCCURRENCE=number 
Specifies the occurrence of the named backup set used in the BACKUP process. 
The default is the first occurrence. 


/[NOJOUTPUT[=filespec] 

This qualifier controls the production of a directory-like listing file that catalogues 
the sequence of events in the BACKUP/DIRECTORY operation. The file specifi- 
cation can be any valid RSTS/E specification (wildcards are not allowed). You can 
use this qualifier to produce a listing of files in the Backup set. /NOOUTPUT is a 
synonym for /NOLIST_FILE. 


The default is your terminal (KB:). 
/[[NO]JPROMPT 
For each BACKUP/DIRECTORY operation a MOUNT prompt is issued, even 


if the Backup set’s device is already mounted. By including the /NOPROMPT 
qualifier in your command line you can eliminate the prompt for the first volume. 


The default is /PROMPT. 
/[NO]JREWIND 


This qualifier indicates whether to rewind the tape before searching for the logical 
end of tape. 


The default is /NOREWIND. 


/SELECT=(filespec-list) 
This qualifier specifies the files you want to list. 


The default is to list all files in the backup set. 
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3.5.3 RESTORE 


Format 


This command restores a RSTS/E disk or subset thereof from a tape or disk 
Backup set. Once RSTS/E determines the syntactic validity of the command 
specification and issues any warning message relative to either the command or 
the environment, RESTORE prompts with: 


Please mount volume 1 of Backup set backup-set-name 
Where can this volume be located <default>? 


At the prompt, enter the device to use or press Return or Line Feed to accept the 
default value. The default value is the device specified as the input parameter. If 
you specify /NOPROMPT, RESTORE omits the prompt message. 


If you are doing a partial restore, and you know what volume to start with, 
start with that volume (although you may start with any volume). RESTORE 
issues a confirmation message and starts with the volume you specify. Note that 
RESTORE may issue a warning message in this case. 


RESTORE  backup-set output-file-spec 


Command Qualifiers 
/CREATED=(date:time) 
/MODIFIED=(date:time) 
/END=action 
/EXCLUDE=(filespec-list) 
/[NO]FILE_DATA 
/INCLUDE=(filespec-list) 
/[NOJINITIALIZE 

/IN -_LABEL=name 
/[NO]LIST_FILE[=filespec] 
/OCCURRENCE=number 
/OUT_LABEL=name 
/[NOJOUTPUT[=filespec] 


Defaults 
See discussion 


/END=DISMOUNT 
None excluded 
/FILE_DATA 

None included 

See discussion 
Volume ID not checked 
/LIST_FILE=KB: 
/OCCURRENCE=1 
See discussion 

Your terminal 


/[NO]PROMPT /PROMPT 
/[NOJQUERY /NOQUERY 
/[NO]JREPLACE[=QUERY] /REPLACE=QUERY 
/[NOJREWIND /NOREWIND 
/SELECT[=(filespec-list)] See discussion 
/[NO]VERIFY[=ONLY] /NOVERIFY 


Prompts 
See discussion 
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Command Parameters 


backup-set 

Identifies the device where the first volume of the Backup set is mounted. The 
Backup set specification should be a standard RSTS/E device specification. If 
you do not specify a device, the default is SY:. PPN is optional and defaults 
to the user’s current account. The file specification is optional and defaults 

to BACKUP.BCK. If the restore operation needs more than one volume in the 
Backup set, RESTORE prompts you for subsequent volumes as follows: 


Please dismount volume 1 of Backup set backup-set-—name 
Please mount volume 2 of Backup set backup-set-name 
Where can this volume be located <default>? 


output-filespec 

Identifies where to put the files or accounts to be restored. The file specification 
should be a standard RSTS/E file specification. If you do not specify device, the 
default is SY:. The PPN is optional and defaults to the user’s current account. 
You can use wildcards in the PPN. The file specification is optional and defaults 
to *.*, You can use standard wildcards. If you specify a filename but not the 
type, BACKUP assumes a * type. If the filename ends with a period, BACKUP 
assumes a null type. If you specify a file type, you must also specify a filename. 
If you specify a wildcard PPN, RESTORE transfers all selected files to: 


e [*,*] — the same accounts as on the Backup set 


e [n,*] — forces the project number to n, uses the programmer number as on 
the Backup set 


e [*,n] — forces the programmer number to n, uses the project number as on 
the Backup set 


Command Qualifiers 


/CREATED=date:time 

/MODIFIED=date:time 

The /CREATED and /MODIFIED qualifiers let you select the files to be restored, 
as chosen by the file selection criteria (see the output-file-spec description), based 
on the creation dates/times and/or revision dates. If no file selection criteria exist, 
these qualifiers apply to all files on the input volume to which you have access for 
this operation. You can use /CREATED and /MODIFIED in conjunction with each 
other; they are not mutually exclusive. To be selected, a file has to satisfy all the 
criteria you specify. 


You can specify an exact date or a range of dates for either qualifier. In the 
range of dates format, each qualifier must take an argument of one or both of the 
subqualifiers, BEFORE or AFTER. The order of the subqualifiers in the argument 
is immaterial. If you specify both BEFORE and AFTER dates for either one of 
the qualifiers, the AFTER date must be earlier than the BEFORE date. 


If you do not use either (CREATED or /MODIFIED, all specified files are selected 
for transfer from the Backup set. 


NOTE 


BACKUP retains both the creation and revision dates as they were on 
the source volume for the files transferred if you have DATES privilege. 
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/END=action 

REWIND causes the magnetic tape to be rewound to the load point and 
dismounted following successful completion of the RESTORE operation. 
/END=NOREWIND causes the magnetic tape to remain positioned after the 
most recent Backup set. The default is END=NOREWIND. 


If you want the Backup set’s device to remain mounted at the end of the BACKUP 
operation, specify END=NODISMOUNT in the command line. The default is 
END=DISMOUNT. 


/EXCLUDE=(filespec-list) 

Lets you specify files that you want to be excluded from the RESTORE opera- 
tion. You can include a list of file specifications in the command line up to the 
maximum length of a DCL command line. 


/[NO]FILE_DATA 

Controls whether file data is transferred during a RESTORE operation. If you 
specify /FILE_DATA, RESTORE transfers the file data from the Backup set to 
the RSTS/E volume. If you specify /NOFILE_DATA, RESTORE proceeds without 
restoring any of the specified files. The default is /FILE_DATA. 


/INCLUDE=(filespec-list) 

Lets you specify files that you want to be unconditionally processed. You can 
include a list of file specifications in the command line up to the maximum length 
of a DCL command line. 


Files in this set override those specified with the /EXCLUDE qualifier. 


/[NOJINITIALIZE 
Specifies the disposition of the output media prior to the data transfer operation. 


The /AINITIALIZE qualifier specifies that RESTORE should disregard any file 
structure on the disk and reinitialize the volume with a RSTS/E file structure as 
if it were done with the INITIALIZE command. 


You can only specify /NOINITIALIZE when the RESTORE operation is from a 
Backup set to an existing RSTS/E disk. In this case, RESTORE places the files 
on the existing file structures instead of replacing them. 


/IN-LABEL=name 

Specifies the name to be compared to the source volume ID. If you use this qual- 
ifier, the source volume ID must equal the specified name before the RESTORE 
operation can be performed. 


/[NOJLIST_FILE[=file-spec] 

Generates a directory-like listing file, cataloguing the sequence of events in 
the RESTORE operation. If you specify /LIST_FILE, you must include the file 
specification. It can be any legal RSTS/E file specification (wildcards are not 
allowed). The default is /LIST_FILE=KB:. 


/OCCURRENCE=number 

Indicates the particular occurrence of a named Backup set to use when more than 
one Backup set of the same name exists on a magnetic tape. You must specify the 
argument which refers to the position relative to either the current tape position 
or the beginning of the tape depending on the use of /[LNOJREWIND. 


RSTS/E Backup sets are interchangeable with VAX Backup sets. However, VAX 
Backup set names can be greater than six characters, while RSTS/E looks at 
only the first six characters. Therefore, RSTS/E cannot distinguish between two 
VAX names that have the same first six characters (for example, ABCDEF and 
ABCDEFG). To transfer ABCDEFG, you must use ABCDEF/OCCURRENCE=2. 
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The default is /OCCURRENCE=1; the first occurrence of the named Backup set. 


/OUT_LABEL=name 
Specifies the desired name for the output volume ID. The resultant name can 
vary depending on the interaction between /OUT_LABEL and /[NO]JINITIALIZE. 


Table 3-3 summarizes the possible outcomes from the interaction of 
/[LNOJINITIALIZE and /OUT_LABEL during RESTORE. 


Table 3-3: /INITIALIZE and /OUT_LABEL Interaction During RESTORE 


Qualifiers Specified Output Volume ID 

/OUT_LABEL=name The specified name. 

/INITIALIZE 

/OUT_LABEL=name The specified name; however, the operation is only 

/NOINITIALIZE successful if the output volume label has the same name. 

/INITIALIZE (only) The destination volume name is the same as the source 
volume name. 

/NOINITIALIZE (only) The name is unchanged. 


/[NOJOUTPUT[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the RESTORE operation. The file specification can be any valid 
RSTS/E file specification (wildcards are not allowed). You can use this qualifier 
to produce a listing of files in the Backup set. /NOOUTPUT is a synonym for 
/NOLIST_FILE. The default is your terminal (KB:). 


/[[NO]PROMPT 

Normally, the BACKUP utility issues a MOUNT prompt for each RESTORE 
operation even if the Backup set’s device is already mounted. You can eliminate 
the prompt for the first volume by including the /NOPROMPT qualifier in your 
command line. The default is /PROMPT. 


/[NOJQUERY 

Causes RESTORE to prompt you as to whether each file that meets the selec- 
tion criteria should be transferred. A Y[ES] response effects the transfer. A 
response of N[O] or pressing <RET> bypasses the file. Any other response causes 
RESTORE to reissue the prompt. 


A YES/ALL response causes the current file and all remaining files to be trans- 
ferred without any further prompting. A response of NO/ALL causes the current 
file and all remaining files to be bypassed without any further prompting. 


The default is /NOQUERY. 


/[NO]JREPLACE[=QUERY] 

Indicates what action should be taken if a file to be transferred already exists 

on the output disk. If you specify (REPLACE, RESTORE replaces the file if it 
exists; any existing file is deleted. If you specify /NOREPLACE, RESTORE issues 
a warning and does not replace the file if it already exists. 


The default, /REPLACE=QUERY, prompts you to replace any file that already 
exists. Answer Y or YES to replace the current file. Answer N or NO to not 
replace the existing file and proceed with the next file. 


If you respond YES/ALL to the prompt, all remaining selected files are copied and 
replace existing copies without prompting. If you respond NO/ALL to the prompt, 
all remaining selected files are copied and do not replace existing files without 
prompting. 
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/[NOJREWIND 
Specifies the disposition of a magnetic tape Backup set volume before processing. 
The default is /NOREWIND. 


If you specify /REWIND, the search for the Backup set begins at the heginning 
of the tape. The /NOREWIND qualifier means the search starts at the present 
position. 


If the logical end-of-tape on the volume is found before the desired Backup set, 
the tape is rewound and an error message appears at the terminal. 


/SELECT[=(filespec-list)] 

Lets you select specific files from the input Backup set to be restored. You can 
use the /SELECT qualifier in conjunction with the /EXCLUDE qualifier and the 
/INCLUDE qualifier or both. If you use /SELECT in combination with other 
qualifiers, the file transfer candidates are chosen according to the following 
criteria: 


e All files on the volume for which the user has read access privilege are 
initially considered 


e If you use the /CREATED or /MODIFIED qualifiers, only those files from 
criterion 1 which meet the time bracket standard are considered. 


e If you use the /SELECT qualifier, only those files from criterion 2 that match 
one of the /SELECT file specifications are considered. 


e If you use the /EXCLUDE qualifier, any files from criterion 3 that match one 
of the /EXCLUDE file specifications are removed from consideration. 


e If you use the [INCLUDE qualifier, RESTORE also considers any files 
meeting the inclusion criteria, provided that you have access to them. Note 
that RSTS/E does not consider the /CREATED, /MODIFIED, /SELECT, or 
/EXCLUDE qualifiers when processing the /INCLUDE list. 


/[NO]VERIFY[=ONLY] 

The /VERIFY qualifier specifies that a comparison operation is to be performed on 
all data transferred. This postprocess verification (for multivolume Backup sets, 
all volumes are transferred before any volume is verified) reports the presence 

of any data differences. For any differences found, RESTORE displays the PPN, 
file name, and file type at the user’s terminal. /VERIFY=ONLY causes the verify 
only pass to be made over the same input and output specifications used for 

the backup pass. You can use /VERIFY=ONLY to compare the contents of the 
restored disk with the source disk to determine what files have changed since the 
backup set was created. You can also use this qualifier to verify several backup 
sets on one tape without having to wait for the tape to rewind after each backup 
set. 


The default is /NOVERIFY. 
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Examples 


RESTORE/SELECT=[*, *]PAYROL.DAT MTO:PAYROL.BCK DR1:*.* 


This command restores a file from a save set on tape 


RESTORE MMO:1409MA.BCK DU1:[*,*]*.* 

This command restores a disk from a save set on tape 
RESTORE MTO:DAT17M.BCK/SELECT= - 
(PAYROL.DAT,BENEFI.DAT, VACATI.DAT) DR2:[*.*]*.* 


This command restores a list of files from a save set on tape 


RESTORE/LIST FILE=928FEB.LOG/ACCOUNT DATA MM0:928FEB.BCK DR1:[*.*]*.* 


This command restores a disk from a save set, and if a file exists, replaces it 
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3.5.4 RESTORE/DIRECTORY 
Allows RESTORE to list files within an existing BACKUP saveset. 


Format 


RESTORE/DIRECTORY prompts with: 


Please mount volume 1 of Backup set backup-set-name 
Where can this volume be located <default>? 


At the prompt, enter the device name where the saveset is located. The default is 
the output device you specified in the RESTORE/DIRECTORY command line. 


RESTORE/DIRECTORY backup-set 


Command Qualifiers 
/BRIEF 
/CREATED=date:time 
/MODIFIED=date:time 
/END=action 


/EXCLUDE=(filespec-list) 
/FULL 
/INCLUDE=(filespec-list) 
/IN-_LABEL=name 
/[NO]LIST_FILE[=filespec] 
/OCCURRENCE=number 
/[NOJOUTPUT[=filespec] 
/[NO]PROMPT 
/[NOJREWIND 
/SELECT=(filespec-list) 


Command Parameters 


backup-set 


Defaults 
/BRIEF 
See discussion 


/END=DISMOUNT for disks 
/END=NOREWIND for tapes 
No files excluded 

/BRIEF 

No files included 

Volume ID is not checked 
Your terminal 

First occurrence 

Your terminal 

/PROMPT 

/NOREWIND 

All files 


Identifies the disk or tape that contains the Backup set. The Backup set speci- 
fication should be a standard RSTS/E device specification. You must specify the 
device. PPN is optional and defaults to the user’s current account. The file spec- 
ification is optional and defaults to BACKUP.BCK. If the backup set consists of 
more than one volume, RESTORE/DIRECTORY prompts for subsequent volumes 


as follows: 


Please dismount volume 1 of Backup set backup-set-name 
Please mount volume 2 of Backup set backup-set~-name 
Where can this volume be located <default>? 
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Command Qualifiers 


/BRIEF 
Displays a format similar to the DCL full directory (minus file attributes) and is 
the default qualifier. 


/CREATED=(date:time) 

/MODIFIED=(date:time) 

The /CREATED and /MODIFIED qualifiers let you select the files included in 
the directory listing, as chosen by the file specification criteria, based on the 
creation date/time and/or revision date. If no file specification criteria exist, 
these qualifiers apply to all files on the volume for this operation. You can 

use /CREATED and /MODIFIED in conjunction with each other; they are not 
mutually exclusive. To be selected, a file has to satisfy all the criteria you specify. 


You can specify an exact date or range of dates for either qualifier. In the range 
format, each qualifier must take an argument of one or both of the subqualifiers 
BEFORE or AFTER. The subqualifier order in the argument is immaterial. 


The date-time argument is of the standard form (for example, dd-mmm-yy or 
yy.mm.dd and hh:mm AM or hh:mm PM). You must specify the date. If you do 
not specify the time, it defaults to 00:00. In addition, if you specify the time, you 
must separate it from the date by a colon (:). 


The following generic terms can be used in the subqualifier: 
e TODAY—meaning 00:00 on the current (system) date 
e YESTERDAY—meaning 00:00 on the date previous to the current date 


When used with /CREATED, the generic terms also accept a time argument. 


If you do not specify either (CREATED or /MODIFIED, RESTORE/DIRECTORY 
lists all specified files. 


NOTE 


Files transferred during the backup operation retain their original 
creation and revision dates (that is, the dates on the source volume). 
You need the DATES privilege to keep these original dates; otherwise, 
RSTS/E lists the current date as the creation date of the backed-up file. 


/END=action 
Specifies the disposition of the tape or disk drive at the end of the directory 
listing operation. 


For tapes you can specify /END=[NOJREWIND. /END=REWIND rewinds the tape 
at the end of the directory listing operation. 


For disks you can specify /END=[NO]DISMOUNT. The default is /END=DISMOUNT, 
which logically dismounts the disk drive at the end of the directory listing 
operation. 


/EXCLUDE=(filespec-list) 

Lets you specify files that you want excluded from the RESTORE/DIRECTORY 
operation (for example, [0,1JSWAP?.SYS). You can include a list of file specifica- 
tions in the command line up to the maximum length of a DCL command line. 
The default is that no files are excluded. 
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/FULL 
Displays detailed information for each file on multiple lines. 


To display information for specific files use /CREATED, /MODIFIED, /EXCLUDE, 
/INCLUDE, and /SELECT. 


/INCLUDE=(filespec-list) 

Lets you specify files or accounts that you want to be unconditionally listed. You 
can include a list of file specifications in the command line up to the maximum 
length of a DCL command line. 


Files in this set override those excluded with the /EXCLUDE qualifier. 


/IN_LABEL=name 

Specifies the name to be compared to the backup set volume ID. If you 
use this qualifier, the volume ID must equal the specified name before 
RESTORE/DIRECTORY can perform the requested operation. 


/[NOJLIST_FILE[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the RESTORE/DIRECTORY operation. The file specification can be 
any valid RSTS/E file specification (wildcards are not allowed). The default is 
your terminal (KB:). 


You can use this qualifier to produce a listing of files in the Backup set. 


/OCCURRENCE=number 
Specifies the occurrence of the named backup set used in the backup process. The 
default is the first occurrence. 


/[NOJOUTPUT{[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the RESTORE/DIRECTORY operation. The file specification can 

be any valid RSTS/E file specification (wildcards are not allowed). You can use 
this qualifier to produce a listing of files in the Backup set. /NOOUTPUT is a 
synonym for /NOLIST_FILE. The default is your terminal (KB:). 


/[NO]JPROMPT 

Normally, the Restore utility issues a MOUNT prompt, for each 
RESTORE/DIRECTORY operation even if the Backup set’s device is already 
mounted. You can eliminate the prompt for the first volume by including the 
/NOPROMPT qualifier in your command line. The default is /PROMPT. 


/[NOJREWIND 
For tape backup files, indicates whether to rewind the tape before searching for 
the logical end of tape. The default is /NOREWIND. 


/SELECT=(filespec-list) 
Specifies the files you want to list. The default is to list all files in the backup set. 
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3.6 Sorting Files and 


erging Sorted Files 


The commands in this section let you reorder the contents of a file or files, and 
combine several sorted files into a single output file. 


3.6.1 SORT 


The SORT command invokes the PDP-11 SORT utility to reorder the records 
in one through ten files into a defined sequence and to create a single new file 


Format 


containing the reordered records. 


This section provides basic command and syntax information for the SORT 
command. For complete details on the qualifiers and additional information 
on how to define and control SORT operations, see the PDP-11 SORT /MERGE 


User’s Guide. 


SORT _ input-file-specf,...)/qualifiers output-file-spec/qualifiers 


Command Qualifiers 


/COLLATING_SEQUENCE=sequence 


/[NO]DUPLICATES 
/KEY=(field[,...]) 
/PROCESSstype 
/SPECIFICATION|[=filespec] 
/[NO]STABLE 
/[NO]STATISTICS 
/WORK_FILES=n 


Input File Qualifiers 
/FORMAT=(file-attribute],...]) 
/INDEXED_SEQUENTIAL[=n] 
/[NOJSHAREABLE 
/TREE_SPACE=n 


Output File Qualifiers 
/ALLOCATION=n 
/BUCKET_SIZE=n 
/[NO]JCONTIGUOUS 
/FORMAT =(record-format{,...]) 
/INDEXED_SEQUENTIAL[=n] 
/LOAD_FILL 
/[NOJOVERLAY=n 
/RELATIVE 

/SEQUENTIAL 


Prompts 
File: input-file-spec[,...]/qualifiers 
Output: _output-file-spec/qualifiers 
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Defaults 
/COLLATING SEQUENCE=ASCII 
/DUPLICATES 
See discussion 
/PROCESS=RECORD 
See discussion 
/NOSTABLE 
/NOSTATISTICS 
none 


See discussion 
Default Value=1 
/NOSHAREABLE 
none 


See discussion 
none 
/NOCONTIGUOUS 
See discussion 
Default Value=1 
none 
/NOOVERLAY 
See discussion 
See discussion 


Command Parameters 


input-file-spec{,...] 
Specifies the names of the file(s) whose records are to be sorted. If the file 
specifications do not include a file type, SORT assumes the default file of .DAT. 


output-file-spec 

Specifies the name of the file into which the sorted records are to be written. Its 
qualifiers can request characteristics for the sorted output file. The command 
string may have only one output file specification. 


If the output file specification does not include a file type, SORT assigns the 
default file type of .DAT to the output file, regardless of the file type(s) of the 
input file(s). 


Command Qualifiers 


/COLLATING_SEQUENCE=sequence 

Specifies the collating sequence in which records are to be arranged. The 
sequence may be ASCII, EBCDIC, or MULTINATIONAL. The default is 
/COLLATING_SEQUENCE=ASCII. 


/DUPLICATES 

/NODUPLICATES 

Alternatively specifies how input files containing records with equal keys are to 
be sorted in the output file (see the previous /[NOJSTABLE qualifier discussion). 
The /NODUPLICATES qualifier specifies that only one record be retained when 
SORT encounters records with equal keys. The default is (DUPLICATES. 


NOTE 


Do not use /NODUPLICATES and /STABLE in the same SORT 
operation. 


/KEY=(field[,...]) 
Defines a SORT key. You can specify this qualifier up to ten times to define ten 
different key fields to be sorted. 


The /KEY qualifier consists of two required arguments that define the position 
and size of the key field within the record, and several optional arguments that 
define the type of data within the key field. You must separate the arguments 
with commas and enclose them in parentheses. 


Required Arguments for the /KEY Qualifier 


POSITION=n Specifies the position of the key within each record, where the first 
character of the record is position 1. 


SIZE=n Specifies the length of the SORT key in characters, bytes, or digits, 
depending on the key field data type. The total of all key field sizes 
must be less than 255 bytes. The valid sizes, based on data type, are: 
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Data Type Values for n 
CHARACTER 1-255 


BINARY 1, 2, 4, 8 
DECIMAL 1-31 
NOTE 


You cannot use the SIZE argument with floating point data types 
(D_FLOATING, F_FLOATING, or ASCII_FLOATING. 


Optional Arguments for the /KEY Qualifier 


CHARACTER 
BINARY 

DECIMAL 
ASCIT_FLOATING 
ASCIT_ZONED 
DIBOL_ZONED 
D_FLOATING 
F_FLOATING 
PACKED_DECIMAL 


SIGNED 
UNSIGNED 


LEADING_SIGN 
TRAILING_SIGN 


OVERPUNCHED_SIGN 
SEPARATE_SIGN 


ASCENDING 
DESCENDING 


/PROCESS=type 


Indicates the type of data in the SORT key field. If not 
specified, SORT assumes that data is CHARACTER. 


Indicates whether a binary or decimal key is to be com- 
pared as a signed or an unsigned integer. UNSIGNED 
causes all numbers to be treated as positive. SIGNED is 
the default. 


Indicates whether the sign of a decimal data type key 
appears at the beginning or end of the key. If you specify 
the key data type as DECIMAL, but do not specify either 
of these subqualifiers, the default is TRAILING_SIGN. 


Indicates whether the sign of a decimal data type key 
is superimposed on the decimal value or is separated 
from the decimal value. If you specify the key data 
type as DECIMAL, but do not specify either of these 
subqualifiers, the default is OVERPUNCHED_SIGN. 


Indicates whether the key is to be sorted into ascend- 
ing or descending order. If you specify neither of these 
subqualifiers, the default is ASCENDING. 


Defines the type of sort. You can specify one of the following sort types: 


RECORD 


Requests SORT to resequence the entire contents of the input file(s) 


and create an output file containing the reordered records. 


TAG Requests SORT to sort only the record keys, and then reaccess 
the input files to create an output file containing the resequenced 


records. 


ADDRESS 


Requests SORT to produce an address file sorted by record keys. 


The output file can be read as an index to read the original file in 
the desired sequence. 


INDEX Requests SORT to produce an address file containing the key field of 
each data record and a pointer to its location in the input file. The 
output file can be read to randomly access the data in the original 
file in the desired sequence. 


The default is /PROCESS=RECORD. 
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/SPECIFICATION[=file-spec] 

Indicates that commands and file qualifiers, including key field definitions, are 
contained in a specification file. See the PDP-11 SORT /MERGE User’s Guide for 
complete details on using specification files. 


/STABLE 

/NOSTABLE 

Specifies how input files containing records with equal keys are to be sorted in the 
output file. The default is /(NOSTABLE, which causes any records with equal keys 
to be grouped together in the output file, possibly resulting in an unpredictable 
sort order for those particular records. The /STABLE qualifier specifies that 

any records with equal keys are to be directed to the output file in the order in 
which they were input to SORT. See the following /[NOJDUPLICATES qualifier 
discussion. 


STATISTICS 

/NOSTATISTICS 

Specifies whether a statistical summary displays after the SORT operation 
completes. The default is /NOSTATISTICS. 


/WORK_FILES=n 

Specifies the number of temporary work files to be used during the sort process. 
You can specify 0 or any value from 3 through 10. A value of 0 indicates that no 
work files are necessary because the data will fit in physical memory. 


Input File Qualifiers 


/FORMAT=(file-attributef,...]) 

Specifies attributes of the input file to override the existing data that SORT 
normally obtains through PDP-11 RMS. You can specify one or both of the 
following arguments: 


FILE_SIZE=n Defines the size of the file in blocks. This argument is required for 
files that are not on disk or magnetic tape. 


If no input file size is specified, SORT uses the default value of 1000 
blocks. 


RECORD_SIZE=n Specifies, in bytes, the length of the longest record, overriding 
the record size defined in the file header or label. This argument 
is required for files that are not on disk or magnetic tape, or if 
the longest record length (LRL) is unavailable or known to be 
inaccurate. 


/INDEXED_SEQUENTIAL[=n] 

Specifies that the organization of the input file is indexed-sequential. You specify 
the number of keys (1 through 255) to make sure that SORT allocates sufficient 
RMS space. The default value is 1. 


/SHAREABLE 
/NOSHAREABLE 
Specifies whether the input files are opened in write-shareable mode. Use this 


qualifier when you want to sort files that may be updated by another user during 
the sort operation. The default is /NOSHAREABLE. 
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TREE_SPACE=n 

Specifies the percentage distribution of available work area between 
SORT/MERGE tree-related data structures and I/O-related data structures. 

You can specify from 1 to 100 percent (%). For SORT, the default division of work 
area is 55% to the tree and 45% to I/O. 


Output File Qualifiers 


/ALLOCATION=n 
Specifies the number of 512-byte blocks to be allocated for the output file. By 
default, SORT allocates blocks based on the number of records sorted. 


/BUCKET_SIZE=n 

Used with disk files, this qualifier specifies the number of 512-byte blocks per 
bucket for the output file. The maximum size you can specify is 32 blocks. If you 
do not specify a bucket size, the bucket size of the output file defaults to that of 
the input file. 


/CONTIGUOUS 

/NOCONTIGUOUS 

Specifies whether the allocation of disk space for the output file is to be con- 
tiguous. If you specify /CONTIGUOUS, you must also specify /ALLOCATION 
to define the number of blocks to allocate for the output file. The default is. 
/NOCONTIGUOUS. 


/FORMAT=(record-format{,...]) 
Defines the output file record format. You can specify one or more of the following 


arguments: 

FIXED[=n] Defines the output file record format and size, where n is 
VARIABLE[=n] the length of the longest record in the output file. If n is 
RMS_STREAM[=n] not specified, the default is a length long enough to hold the 
STREAM[=n] longest output record. 

CONTROLLED[=n] 

BLOCK_SIZE=n Specifies, when the output file is directed to disk or magtape, 


the block size in bytes. If one or more input files is a tape file, 
the output file block size defaults to the maximum of the block 
sizes of all tape input files. If the input file is a disk file, the 
default value is 512 bytes. 


/AINDEXED_SEQUENTIAL [=n] 

Specifies that the organization of the output file is indexed-sequential. You 
specify the number of keys (1 through 255) to make sure that SORT allocates 
sufficient RMS space. The default value is 1. 


/LOAD_FILL | 
Used only with indexed files, this qualifier loads the buckets according to the fill 
size established when the file was created. 
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/OVERLAY 

/NOOVERLAY 

Specifies whether an existing file is to be overlaid with the sorted records of the 
input file. The default is /NOOVERLAY, which means a new output file is created 
and does not overlay an existing file. 


/RELATIVE 

Specifies that the organization of the output file is relative. By default, a 
RECORD or TAG sort process results in an output file that has the same 
organization as the input file. Use the (RELATIVE qualifier to create a relative 
output file from a sequential or indexed-sequential input file. 


/SEQUENTIAL 

Specifies that the organization of the output file is sequential. This is the default 
for an ADDRESS or INDEX sort process; for a RECORD or TAG sort process, the 
output file organization defaults to the organization of the input file. 
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3.6.2 MERGE 


The MERGE command invokes the PDP-11 MERGE utility to combine two 
through ten similarly sorted input files and create a single output file. Note that 
input files to be merged must be in sorted order. 


This section provides basic command and syntax information for the MERGE 
command. For complete details on the qualifiers and additional information on 
how to define and control MERGE operations, see the PDP-11 SORT /MERGE 
User’s Guide. 


Format 
MERGE = input-file-spec1,input-file-spec2],...] - 
/qualifiers output-file-spec/qualifiers 


Command Qualifiers Defaults 
/[NO]JCHECK_SEQUENCE /CHECK_SEQUENCE 
/COLLATING_SEQUENCE=sequence /COLLATING_SEQUENCE=ASCII 
/[NO]DUPLICATES /DUPLICATES 
/KEY=(fieldf,...]) See discussion 
/PROCESS=type /PROCESS=RECORD 
/SPECIFICATION|=file-spec] See discussion 
/[NO]STABLE /NOSTABLE 
/[NO]STATISTICS /NOSTATISTICS 
/WORK_FILES=n See discussion 

Input File Qualifiers 

/FORMAT =(file-attribute[,...]) See discussion 
/INDEXED_SEQUENTIAL[=n] Default value=1 
/[NO]JSHAREABLE /NOSHAREABLE 
/TREE_SPACE=n See discussion 
Output File Qualifiers 

/ALLOCATION=n See discussion 
/BUCKET_SIZE=n none 
/[NO]JCONTIGUOUS /NOCONTIGUOUS 
/FORMAT=(record-formatt,...]) See discussion 
/AINDEXED_SEQUENTIAL[=n] Default Value=1 
/LOAD_FILL none 

/[NOJOVERLAY /NOOVERLAY 
/RELATIVE | See discussion 
/SEQUENTIAL See discussion 
Prompts 


File: input-file-spect ,input-file-spec2],...] /qualifiers 
Output: output-file-spec/quailifiers 
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Command Parameters 


input-file-spec1 ,input-file-spec2[,...] 

Specifies the names of the sorted files whose records are to be merged. At least 
two files, but not more than ten, must be specified and separated by commas. The 
keys must be the same in all files. 


If the file specifications do not include a file type, MERGE assumes the default 
file type of .DAT. 


output-file-spec 

Specifies the name of the merged file to be created. Its qualifiers can request 
characteristics for the merged output file. The command string may have only 
one output file specification. 


If the output file specification does not include a file type, MERGE assigns the 
default file type of .DAT to the output file, regardless of the file types of the input 
files. 


Command Qualifiers 


/CHECK_SEQUENCE 

/NOCHECK_SEQUENCE 

Examines the input files to be merged to make sure that they are in order. If a 
record is out of order, MERGE displays the following warning message at the end 
of the merge operation: 


%SOR-E-BAD ORDER, Input file [n] is out of order 


The default is /CHECK_SEQUENCE. 


/COLLATING_SEQUENCE=sequence 

Specifies the collating sequence in which records are to be arranged. The 
sequence may be ASCII], EBCDIC, or MULTINATIONAL. The default is 
/COLLATING_SEQUENCE=ASCII. 


/DUPLICATES 

/NODUPLICATES 

Alternatively specifies how input files containing records with equal keys are to 
be merged in the output file (see the previous /[LNOJSTABLE qualifier discussion). 
The /NODUPLICATES qualifier specifies that only one record be retained when 
MERGE encounters records with equal keys. The default is /DUPLICATES. 


NOTE 


Do not use /NODUPLICATES and /STABLE in the same merge 
operation. 


/KEY=(field[,...]) 
Defines a MERGE key. This qualifier can be specified up to ten times to define 
ten different key fields to be merged. 


The /KEY qualifier consists of two required arguments that define the position 

and size of the key field within the record, and several optional arguments that 
define the type of data within the key field. The arguments must be separated 

with commas and enclosed in parentheses. 
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Required Arguments for the /KEY Qualifier 


POSITION=n Specifies the position of the key within each record, where the first 
character of the record is position 1. 
SIZE=n Specifies the length of the MERGE key in characters, bytes, or digits, 


depending on the key field data type. The total of all key field sizes 
must be less than 255 bytes. The valid sizes, based on data type, are: 


Data Type Values for n 
CHARACTER 1-255 
BINARY 1, 2, 4, 8 
DECIMAL 1-31 

NOTE 


You cannot use the SIZE argument with floating point data types 
(D_FLOATING, F_FLOATING, or ASCII_FLOATING). 


Optional Arguments for the /KEY Qualifier 


CHARACTER Indicates the type of data in the MERGE key field. If not 
BINARY specified, MERGE assumes that data is CHARACTER. 
DECIMAL 


ASCIT_FLOATING 
ASCII_ZONED 
DIBOL_ZONED 


D_FLOATING 

F_FLOATING 

PACKED DECIMAL 

SIGNED Indicates whether a binary or decimal key is to be compared 

UNSIGNED as a signed or an unsigned integer. UNSIGNED causes all 
numbers to be treated as positive. SIGNED is the default. 

LEADING_SIGN Indicates whether the sign of a decimal data type key 

TRAILING_SIGN appears at the beginning or end of the key. If you specify 
the key data type as DECIMAL, but do not specify either of 
these subqualifiers, the default is TRAILING_SIGN. 

OVERPUNCHED SIGN Indicates whether the sign of a decimal data type key is 

SEPARATE_SIGN superimposed on the decimal value or is separated from 
the decimal value. If you specify the key data type as 
DECIMAL, but do not specify either of these subqualifiers, 
the default is OVERPUNCHED_SIGN. 

ASCENDING Indicates whether the key is to be merged into ascend- 

DESCENDING ing or descending order. If you specify neither of these 


subqualifiers, the default is ASCENDING. 
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/PROCESS=type 
Defines the type of merge. You can specify one of the following merge types: 


RECORD Requests MERGE to resequence the entire contents of the input files and 
create an output file containing the reordered records. 

TAG Requests MERGE to merge only the record keys, and then reaccess the 
input files to create an output file containing the resequenced records. 

ADDRESS Requests MERGE to produce an address file merged by record keys. The 
output file can be read as an index to read the original file in the desired 
sequence. 

INDEX Requests MERGE to produce an address file containing the key field 


of each data record and a pointer to its location in the input file. The 
output file can be read to randomly access the data in the original file in 
the desired sequence. 


The default is /PROCESS=RECORD. 


/SPECIFICATION[=file-spec] 

Indicates that commands and file qualifiers, including key field definitions, are 
contained in a specification file. See the PDP-11 SORT /MERGE User’s Guide for 
complete details on using specification files. 


/STABLE 

/NOSTABLE 

Specifies how input files containing records with equal keys are to be merged in 
the output file. The default is /NOSTABLE, which causes any records with equal 
keys to be grouped together in the output file, possibly resulting in an unpre- 
dictable merge order for those particular records. The /STABLE qualifier specifies 
that any records with equal keys are to be directed to the output file in the order 
in which they were input to MERGE. See the following /[NOJDUPLICATES 
qualifier discussion. 


STATISTICS 
/NOSTATISTICS 


Specifies whether a statistical summary displays after the MERGE operation 
completes. The default is /NOSTATISTICS. 


/WORK_FILES=n 

Specifies the number of temporary work files to be used during the merge process. 
You can specify 0 or any value from 3 through 10. A value of 0 indicates that no 
work files are necessary because the data will fit in physical memory. 
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Input File Qualifiers 


/FORMAT=(file-attribute[,...]) 

Specifies attributes of the input file to override the existing data that MERGE 
normally obtains through PDP-11 RMS. You can specify one or both of the 
following arguments: 


FILE_SIZE:n Defines the size of the file in blocks. This argument is required for 
files that are not on disk or magnetic tape. 


If no input file size is specified, MERGE uses the default value of 
1000 blocks. 


RECORD_SIZE:n Specifies, in bytes, the length of the longest record, overriding 
the record size defined in the file header or label. This argument 
is required for files that are not on disk or magnetic tape, or if 
the longest record length (LRL) is unavailable or known to be 
inaccurate. 


[INDEXED SEQUENTIAL[=n] 

Specifies that the organization of the input file is indexed-sequential. You specify 
the number of keys (1 through 255) to make sure that MERGE allocates sufficient 
RMS space. The default value is 1. 


/SHAREABLE 
/NOSHAREABLE 
Specifies whether the input files are opened in write-shareable mode. Use this 


qualifier when you want to merge files that may be updated by another user 
during the merge operation. The default is /(NOSHAREABLE. 


TREE_SPACE=n 

Specifies the percentage distribution of available work area between 
SORT/MERGE tree-related data structures and I/O-related data structures. 
You can specify from 1 to 100 percent (%). The default division of work area is 
30% to the merge list and 70% to I/O. 


Output File Qualifiers 


/ALLOCATION=n 
Specifies the number of 512-byte blocks to be allocated for the output file. By 
default, MERGE allocates blocks based on the number of records sorted. 


/BUCKET_SIZE 

Used with disk files, this qualifier specifies the number of 512-byte blocks per 
bucket for the output file. The maximum size you can specify is 32 blocks. If you 
do not specify a bucket size, the bucket size of the output file defaults to that of 
the input file. 


/CONTIGUOUS 

/NOCONTIGUOUS 

Specifies whether the allocation of disk space for the output file is to be con- 
tiguous. If you specify /CONTIGUOUS, you must also specify /ALLOCATION 
to define the number of blocks to allocate for the output file. The default is 
/NOCONTIGUOUS. 


3-66 WORKING WITH FILES 


/FORMAT=(record-formatt....]) 
Defines the output file record format. You can specify one or more of the following 
arguments: 


FIXED[=n] Defines the output file record format and size, where n is 
VARIABLE[=n] the length of the longest record in the output file. If n is 
RMS_STREAM[=n] not specified, the default is a length long enough to hold the 
STREAM[=n] longest output record. 

CONTROLLED[=n] 

BLOCK_SIZE=n Specifies, when the output file is directed to disk or mag- 


tape, the block size in bytes. If one or more input files is a 
tape file, the output file block size defaults to the maximum 
of the block sizes of all tape input files. If the input file is a 
disk file, the default value is 512 bytes. 


/[INDEXED_SEQUENTIAL[=n] 

Specifies that the organization of the output file is indexed-sequential. You 
specify the number of keys (1 through 255) to make sure that MERGE allocates 
sufficient RMS space. The default value is 1. 


/LOAD_FILL 
Used only with indexed files, this qualifier loads the buckets according to the fill 
size established when the file was created. 


/OVERLAY 

/NOOVERLAY 

Specifies whether an existing file is to be overlaid with the sorted records of the 
input file. The default is /NOOVERLAY, which means a new output file is created 
and does not overlay an existing file. 


/RELATIVE 

Specifies that the organization of the output file is relative. By default, a 
RECORD or TAG sort process results in an output file that has the same 
organization as the input file. Use the /RELATIVE qualifier to create a relative 
output file from a sequential or indexed-sequential input file. 


/SEQUENTIAL 

Specifies that the organization of the output file is sequential. This is the default 
for an ADDRESS or INDEX sort process; for a RECORD or TAG sort process, the 
output file organization defaults to the organization of the input file. 
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3.7 Comparing Files: DIFFERENCES 


The DIFFERENCES command compares two text files and lists any sections of 
text that differ between the two files. 


Format 
DIFFERENCES input-file-spec | compare-file-spec 
Command Qualifiers Defaults 
/IGNORE=BLANK_LINES See discussion 
/MATCHssize /MATCH=3 
/MAXIMUM_DIFFERENCES=n /MAXIMUM_DIFFERENCES=300 
/OUTPUT=file-spec /OUTPUT=KB: 
Prompts 
File 1: — input-file-spec 


File 2: | compare-file-spec 


DIFFERENCES compares the two files by groups of lines and produces an output 
file if the /OUTPUT qualifier is used; otherwise, output is sent to the terminal. 
This output file lists the differences, if any. 


The qualifiers for the DIFFERENCES command can be categorized according to 
their functions: 


e The [AAGGNORE=BLANKLINES qualifier requests DIFFERENCES to ignore 
blank lines while comparing files. 


By default, DIFFERENCES compares every line in each file. 


e The /MATCH and /MAXIMUM_DIFFERENCES qualifiers control the extent 
of the comparison. 


By default, DIFFERENCES reads every line in the first input file and looks 
for a matching line in the second input file. Lines are considered matched 
only if three identical sequential lines are found in each file. 


The DIFFERENCES command normally displays its report at your terminal. 
Use the /OUTPUT qualifier to request DIFFERENCES to write the output to an 
alternate file or device. If the two files are significantly different, then the system 
may print one of the following error messages: 


?Maximum memory exceeded 


?Maximum differences (300) encountered - skipping rest of file 


For example, you may want to use DIFFERENCES to compare a file (such as 
HOME.WRE) with its earlier backup version (HOME.BAK). The command line 
you enter is: 
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RSTS/E displays a message telling you which files it is comparing: 
Comparing: 1) SY¥:[2,214]HOME.WRK to 2) SY: [2,214]HOME.BAK 


Because you did not include a directory in the command line, the default is your 
directory. 


Next, RSTS/E displays the lines containing text that does not match. The 
sections in the following example are labeled 1) and 2), corresponding to the first 
and second file being compared. The sections of text are separated by rows of 
asterisks (*): 


REKKKKEKKKKKKKEKKEKEKKEKEKKKKKKKKKEKK 


1) S¥:[2,214]HOME.WRK 
the writings of Milton and 
Donne. Fortunately, I find 


their work interesting. 
KRKKKKKKKKK 


2) SY¥:[2,214]HOME.BAK 

the writings of Marchand and 
Hogan. Fortunately, I find 
their work interesting. 


?1 Difference Found 
Notice that the numbers 1) and 2) correspond to HOME.WRK and its backup 


version, HOME.BAK. DIFFERENCES lists the differences in the two files one 
group of lines at a time. 


Command Parameters 
input-file-spec 
Specifies the name of the first input file to be compared. 


You must include a file name. The default file type is null. You cannot use 
wildcard characters in the file specification. 


compare-file-spec 
Specifies the name of the second input file to be compared. 


You must include a file name. The default file type is null. 


Command Qualifiers 


/IGNORE=BLANK_LINES 

Specifies that blank lines between data lines are to be ignored during the 
comparison. By default, the DIFFERENCES command compares every line in 
each file and reports all differences. 


For example, if files REGAN.TOM and REGAN.SAM have similar contents but 
have unequal numbers of blank lines, you can disregard the blank lines in their 
comparison by typing: 


$ DIFFERENCES REGAN.TOM REGAN.SAM/IGNORE=BLANK LINES <RET> 
/MATCHesize 
Controls the number of lines that must be identical for DIFFERENCES to 


consider them a match. For example, to make sure that five identical lines are 
found to be considered a match between MARYB.TXT and BILL.TXT, type: 


S$ DIFFERENCES MARYB.TXT BILL.TXT/MATCH=5 <RET> 


By default, after DIFFERENCES finds unmatched lines, it assumes that the files 
match after it finds 3 sequential lines that match. The match size you specify 
overrides the default value of 3. 
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/MAXIMUM_DIFFERENCES=n 

If you specify /MAXIMUM_DIFFERENCES, DIFFERENCES terminates after 
locating n differences. The output file lists differences only on lines compared 
until the maximum has been reached. 


For example, you may need to compare two large data files (MIKE.DAT and 
EDDIE.DAT), but if more than four differences are found, any further comparison 
would not be worth your while. In this case you type: 


S$ DIFFERENCES MIKE.DAT EDDIE.DAT/MAXIMUM DIFFERENCES=4 <RET> 


By default, DIFFERENCES aborts after 300 differences are found. 


/OUTPUT=file-spec 

Stores the result of the comparison in a file rather than displaying it at your 
terminal. If you omit the /OUTPUT qualifier, the output displays at your 
terminal. 


The /OUTPUT qualifier is especially useful if you are using a video terminal 
and want a listing of the output. For example, you can request that the output 
from comparing files RACE.A and RACE.B be stored in a file that you name 
RESULT.C: 


S$ DIFFERENCES RACE.A RACE.B/OUTPUT=RESULT.C <RET> 


If you specify /OUTPUT without a file specification, the output goes to a file with 
the same file name as the first input file and a file type of .DIF. If you had not 
assigned the file name RESULT.C in the previous example, it would have been 
named RACE.DIF. 


You cannot use wildcard characters in the file specification. 
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3.8 Allowing Access to Files 


This section describes what it means to assign protection codes to your files. Then 
it explains how to use the SET PROTECTION command and the /DEFAULT 
qualifier. 


3.8.1 Using Protection Codes 


A protection code determines who has access to a file. 


The protection code consists of one to three decimal digits. This code determines 
the file’s degree of protection on two levels: 


e The actions (reading, writing, executing, and deleting) against which it is 
protected. Anyone who can write in a file can also delete it, and vice versa. 


e The user or class of users against whom it is protected. 


RSTS/E recognizes three classes of users for protection purposes: 


¢ Owner — The owner of the file, known to the system by a PPN (such as 
[52,20)). 


¢ Group — The owner’s group, known to the system by any PPN whose project 
number (the 52 in [52,20]) is the same as the owner’s project number. Group 
read or write access also allows the owner read or write access. 


¢ World — All other users on the system, known to the system by any PPN 
whose project number is different from the owner’s. World read or write 
access also allows both the owner and the owner’s group read or write 
access. 


For example, 60 is the default protection code that RSTS/E normally assigns. 
(The code is something other than 60 if your system manager changed the 
default, or if you use the SET PROTECTION/DEFAULT command described in 
the next section.) If one of your files has a protection code of 60, only you or 

a user with sufficient privileges can read, edit, or delete it. A protection code 
remains fixed unless you change it. 


NOTE 


Some users on your system (for example, the system manager) may 
have privileges that allow them to access files regardless of the 
protection codes. 


When you create a file, RSTS/E assigns it the default protection code 60: 


S$ CREATE ANNIE.DAT <RET> 
Here’s a file of only one line. 
4Cerl/ a> 1 


S$ DIR ANNIE.DAT <RET> 


Name .Typ Size Prot Name .Typ Size Prot eis (52; 20] 
ANNIE .DAT 1 < 60> 


Total of 1 block in 1 file in SY: [52,20] 
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You assign a protection code with the SET PROTECTION command, as in: 


$ SET PROTECTION=40 ANNIE.DAT <RET> 
ANNIE -DAT renamed to ANNIE -DAT<40> 
rs} DIR ANNIE.DAT <RET> 


Name .Typ Size Prot Name .Typ Size Prot SY¥<s (52, 20] 
ANNIE .DAT 1 < 40> 


Total of 1 block in 1 file in SY: [52,20] 


A factor in assigning protection codes is whether a file is executable. An exe- 
cutable file is produced by the LINK command or by the COMPILE command of 
BASIC-PLUS or BASIC-PLUS-2. An executable file contains the protection code 
64. 


A nonexecutable file, on the other hand, is any file that does not contain a 
protection code of 64. Table 3-4 lists the file protection codes for nonexecutable 
files. 


Table 3-4: File Protection Codes for Nonexecutable Files 


Code Meaning 

1 Protection against reading by owner 

2 Protection against writing by owner 

4 Protection against reading by owner’s group 

8 Protection against writing by owner’s group 

16 Protection against reading by anyone not in the owner’s group 
32 Protection against writing by anyone not in the owner’s group 
128 A protected data file; overwritten with zeros when deleted 


Individual codes added to the executable protection code 64 have meanings 
different from those above. 


Table 3-5 lists the compiled codes for executable files (64 + code). 


Table 3-5: File Protection Codes for Executable Files 


64+Code Meaning 


1 Execute protection against the owner 

2 Read and write protection against the owner 

4 Execute protection against the owner’s group 

8 Read and write protection against the owner’s group 

16 Execute protection against all others not in the owner’s group 

32 Read and write protection against all others not in the owner’s group 
128 Program with privileges 


The protection code you set for a file is the total of the code numbers for the 
types of protection you want. For example, the usual system default (60) protects 
against reading, writing, and deleting by all users except its owner, because it is 
a sum of 4, 8, 16, and 32. 
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Table 3-6 lists common codes and their meanings. 


Table 3-6: Common File Protection Codes 


Code 
232 


124 


104 


62 


60 


48 


40 


Sum of Codes 


128+64+32+8 


644324 164+8+4 


644+32+8 


32+164+8+4+42 


32+ 16+8+4 


32+16 


32+8+42 


32+8 


Meaning 


Executable file that is privileged and protected against 
reading and writing by anyone except owner. However, 
anyone can execute the file. 


Executable file that is protected against reading, writing, and 
execution by anyone except owner. 


Executable file that is protected against reading and writing 
by anyone except owner. However, anyone can execute the 


file. 


Protected against reading by anyone except owner. Protected 
against accidental deletion or modification by owner or anyone 
else. 


Protection against reading and writing by anyone except 
owner. 


Protection against reading and writing by anyone not in 
owner’s group. Can be read or written by anyone in owner’s 


group. 
Protection against writing by anyone including owner; read- 
able by everyone. 


Protection against writing by anyone except owner; readable 
by everyone. 


No protection (any user can read, write, and delete). 
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3.8.2 SET PROTECTION 


Format 


The SET PROTECTION command specifies the protection code of a file. You 
assign a protection code to determine who else, if anyone, can have access to vour 
files. (To check the protection codes of your files, use the /PROTECTION qualifier 
with the DIRECTORY command.) 


A file specification and protection code are required unless you use the /DEFAULT 
qualifier. You must include either an equal sign or a space between the command 
SET PROTECTION and the protection code you specify. 


SETPROTECTION[=]n _filespecy....] 


Command Qualifiers Defaults 
/BEFORE=date none 
/[NO]CONFIRM /NOCONFIRM 
/CREATED none 
/DEFAULT /DEFAULT 
/MODIFIED none 
/[NOJQUERY /NOQUERY 
/[NO]LOG /LOG 
/SELECT=SIZE=n See discussion 

=MINIMUM=n 

=MAXIMUM=n 

=(MINIMUM=m, MAXIMUM=n) 
/SINCE=date none 


For example, you set the protection code of a file named TIME.TRY to 42 by 
typing: 


$ SET PROTECTION=42 TIME.TRY <RET> 


Command Parameters 


Nn 

The value you specify for n can be any of the protection codes in Table 3-4, 
Table 3—5, and Table 3-6, depending on the privileges you have been given by the 
system manager. 


filespec[,...] 
You can include one or more file specifications in the command string. Wildcard 
characters are allowed. 
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Command Qualifiers 


/BEFORE=date 

/SINCE=date 

/CREATED 

/MODIFIED 

Changes the protection codes of files created or modified before or since the 
specified date. See Chapter 2 for information on specifying dates and times. 


/ CONFIRM 
/NOCONFIRM 


Prompts for permission to change a file protection code. This qualifier is 
synonymous with /QUERY. The default is /NOCONFIRM. 


/DEFAULT 

The /DEFAULT qualifier specifies the default protection code of each file you 
create. (You can override the default for individual files.) /DEFAULT stays in 
effect until you logout. 


If you use SET PROTECTION/DEFAULT, RSTS/E assigns the protection code 
you specify to all files you create during the current session. Do not include a file 
specification when you use the /DEFAULT qualifier. Also, you must include either 
an equal sign or a space between the command and the protection code: 


SET PROTECTION [=]n/DEFAULT 


/QUERY 

/NOQUERY 

The /QUERY qualifier prompts you to state whether you want to change a file’s 
protection code. The default is /NOQUERY. 


The /QUERY qualifier is useful only when you use wildcards in the file spec- 
ification. You can enter one of the following responses to the question mark 
prompt: 


Y Yes, change the protection code 

N No, do not change the protection code 
<RET> No, do not change the protection code 
<Ctrl/Z> Return to command level 


For example, if you have several files named MOODY, you can determine their 
protection codes as follows: 


S SET PROTECTION=40/QUERY MOODY.* <RET> 
[52,20]MOODY .DAT? Y <RET> 

MOODY .DAT renamed to MOODY.DAT < 40> 
[52,20]MOODY .LIN? N <RET> 

[52,20]MOODY .JON? <Ctrl1/Z> 


Do not use either the /QUERY or /NOQUERY qualifiers with /DEFAULT. 
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/LOG 

/NOLOG 

Determines whether RSTS/E displays a message to confirm that a file’s protection 
code was changed. The default is /LOG. To suppress the message when changing 
the protection code of a file (such as STRIPE.LIS), type: 


§ SET PROTECTION=64 STRIPE.LIS/NOLOG <RET> 


Unless you specify /NOLOG, a message displays: 


S SET PROTECTION=64 STRIPE.LIS/LOG <RET> 
STRIPE.LIS renamed to STRIPE.LIS < 64> 


Do not use /LOG or /NOLOG with /DEFAULT. 


/SELECT=SIZE=n 

/SELECT=SIZE=MINIMUM=n 
/SELECT=SIZE=MAXIMUM=n 
/SELECT=SIZE=(MINIMUM=m,MAXIMUM=n) 

Selects files based on their size. The specified size can be: 


n Selects only those files with size equal to n. 
MINIMUM=n Selects only those files with size greater than or 
equal to n. 
MAXIMUME=En Selects only those files with size less than or 
| equal to n. 
MINIMUM=m,MAXIMU Men Selects only those files with size between m and n 
inclusive. 
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3.9 Setting File Characteristics: SET FILE 


Format 


In addition to the SET PROTECTION command described in the previous section, 
you can use the SET FILE command to specify protection code, as well as other 
characteristics of a file. 


SET FILE  file-spec 


Command Qualifiers Defaults 
[NO]JBACKUP none 
[NO]JCACHE see discussion 
=RANDOM 
=SEQUENTIAL 
/NOCONTIGUOUS none 
/[NO]DELETABLE none 
/[NO]IGNORE none 
/[NO]LOG See discussion 
/[NO]JPLACED none 
/PROTECTION=n none 
/RUNTIME_SYSTEM=name none 


Command Parameters 


file-spec 
Specifies the file whose characteristics you want to set or change. 


Command Qualifiers 


/BACKUP 

/NOBACKUP 

Indicates whether BACKUP records the contents of the file. The /NOBACKUP 
qualifier causes BACKUP to record the attributes of the file but not its contents. 


The /NOBACKUP qualifier is useful for saving files that contain unimportant 
data, such as SWAPFILES. 


/CACHE 

/CACHE=RANDOM 

/CACHE=SEQUENTIAL 

/NOCACHE 

Determines whether a file is cached when open and, specifies the caching mode. 


You can specify either RANDOM or SEQUENTIAL for the cache-mode parameter, 
which marks the file’s UFD entry so that the file is automatically cached when 
open. 


The default is /CACHE=RANDOM if you do not specify a cache-mode parameter. 


The /NOCACHE qualifier specifies that the file is not automatically cached when 
open. To cache such a file, use the SET CACHE/ALL command. 
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/NOCONTIGUOUS 
Lets you extend a contiguous file by changing it to noncontiguous. 


/DELETABLE 

/NODELETABLE 

Indicates whether a file can be deleted or renamed during timesharing. In 
a directory listing, RSTS/E shows NODELETABLE files by displaying the P 
(protected) flag after the size. 


/IGNORE 

/NOIGNORE 

Indicates whether BACKUP looks at the file. The /IGNORE qualifier causes 
BACKUP to completely ignore the file during all operations. 


The /IGNORE qualifier is used for excluding temporary files from backup sets. 


/LOG 

/NOLOG 

Specifies whether the file specification of each modified file is displayed at the 
terminal. If the file specification contains any wildcards, the default is /LOG. 
Otherwise, the default is /NOLOG. 


/PLACED 

/NOPLACED 

Specifies whether a file, after modification, is placed at its present position on the 
disk. 


/PROTECTION=n 

Specifies the protection code of a file. The protection code must be in the range 
0 to 255. You can also use the SET PROTECTION command, described in the 
previous section, to specify a file’s protection code. 


/RUNTIME_SYSTEM=name 
Specifies the run-time system associated with the file. 
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Chapter 4 


System and Account Operations 


This chapter describes the commands that let you perform common system and 
account operations, such as: 


¢ Displaying system status 
e Displaying account information 
e Changing your password 


e Sending a message to the system operator’s terminal 


4.1 SHOW 


Format 


Use the SHOW command to display information about the system and its 
resources, as well as the current status of your job or account. 


To specify the type of information you want the SHOW command to display, use 
one of the options listed in Table 4—1. 


NOTE 


The SHOW command has additional capabilities for users with greater 
levels of privilege. See the RSTS/E System Manager’s Guide for more 
information. 


SHOW option 
Table 4—1 lists the options that you can use with the SHOW command. 


Table 4-1: SHOW Command Options 


Option Displays 

ACCOUNT Information about accounts. See this 
chapter for more information. 

BUFFERS Information about available buffers, 


in-use and maximum job count, hung 
terminal count, and total logged errors. 


(continued on next page) 
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Table 4-1 (Cont.): SHOW Command Options 


Option 


CACHE 
COUNTERS/LAT 


DATE 
DAYTIME 
TIME 


DEVICE [dev[:]] DEVICE/ALL 


DEVICE/ALLOCATED 


DISKS 


ENTRY [entry] 
ENTRY/ALL 


FILE [file-spec] 
FILE/ALL 


JOB [job-number] 
JOB/ALL 


JOB/PRIVILEGES 
LIBRARY 


LOGICAL [name] 
MEMORY 

NETWORK 

NODE/LAT 
OPERATOR_SERVICES 
PORT [name{[:]] 

PRINTER [printer-name[:]] 


PRINTER/ALL 


QUEUVE [queue-name|:]] 
QUEUE/ALL 


RECEIVERS 
RUNTIME_SYSTEMS 
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Displays 


Current cache settings. 


Information about counters that is 
relevant to managing LAT on the host 
node. 


Current date and time. 


Status of devices in use on the system, or 
a device you specify. See Chapter 6 for 
more information. 


All allocated or open devices, excluding 
terminals and disks. See Chapter 6 for 
more information. 


Status of all mounted disks. See Chapter 
6 for more information. 


Print or batch entries that have been 
queued. See Chapter 7 for more informa- 
tion. 


Information about installed files on 
the system. See the RSTS/E System 
Manager’s Guide for more information. 


Status of jobs on the system. See this 
chapter for more information. 


Privileges assigned to your account. 


All installed resident libraries and 
dynamic regions. 


Information about a logical name, or 
all systemwide and user-defined logical 
names. 


Status of system memory allocation. 


Names of the nodes that your system can 
access. 


Information about the current LAT host 
node characteristics. 


Status of the Operator Message Services 


(OMS) package. 


Characteristics of LAT ports on the 
RSTS/E node. 


Characteristics of all printers on the 
system, or the printer you specify. 


Characteristics of a print or batch queue. 
See Chapter 7 for more information. 


Status of all declared message receivers. 


Status of all installed run-time systems. 


(continued on next page) 
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Option 


SERVER [server-name[:]] 
SERVER/ALL 


SERVICES/LAT [service_name] 
SESSIONS [server_name] 


SYMBOL [symbol-name] 
SYMBOL/ALL 


SYSTEM 
TERMINAL 
TERMINAL SERVERS/LAT [server_name] 


USER [PPN] 
USER/ALL 


Displays 


Characteristics of one or more servers in 
the Print/Batch Services (PBS) facility. 
See the RST'S/E System Manager's 


Guide for more information. 


Information about the service(s) offered 
by the LAT host node. 


Information about the sessions currently 
running LAT on the host node. 


Value of a specified symbol or all symbols 
in a local symbol table or the global 
symbol table. See Chapter 6 for more 
information. 


System default characteristics. See this 
chapter for more information. 


Characteristics of your terminal. See 
Chapter 5 for more information. 


Information about the terminal server 


known to the LAT host node. 


Information about attached jobs, or all 
jobs, on the system. See this chapter for 
more information. 
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4.2 System and Account Status 


The SHOW USER command displays information about users who are logged in 
and what system resources they are using. The SHOW JOB command displays 
the status of your current job. The SHOW SYSTEM command displays the 
default characteristics of the system. The SHOW ACCOUNT command displays 
data about an account. 


The following is an example of the SHOW USER command, along with an 
explanation of each numbered element in the display: 


$ SHOW USER <RET> 
1 RSTS V10.0-L status at 09-Jun-90, 05:50 PM Up: 2 6:22:19. 


Z | 4 5 6 7 8 9 
Job Who Where What Size State Run-Time RTS 
3 1,226 KB27 NET 17/64K SL 3.4 «««RSX 
5 1,214 KB26 SYSTAT 20/64K RN Lek Sez . et eo 
11 1,196 KB30* DCL 4/64K ~S 9:39.4 DCL 
14 1,231 KB45! BACKUP 15/64K SL 8213.6 = « «ee 


The display tells you the following: 


1. System status information — You are using RSTS/E Version 10.0-L software. 
At the present day and time (09-Jun-90, 05:50 PM) the system has been 
operating for 2 days, 6 hours, 22 minutes, and 19 seconds (Up: 2 6:22:19). 


2. Job — There are five attached jobs now in use on the system. 
Who — This column displays the accounts to which the jobs belong. 


4, Where — This column displays the keyboards controlled by the jobs. The 
asterisk (*) following KB30 indicates a dialup line. 
The exclamation point (!) following KB45 indicates a LAT line. 


What — Various operations (SYSTAT, BACKUP) are being performed. 


Size — These numbers indicate both the actual size of your job, as well as the 
size to which the job can expand. The size is shown in thousands of words — 

or K words — of computer storage space. In computing, K approximates 
thousand-word units of memory storage (actually 1K=1024 words). The Size 
column is mainly to tell you the load each job places on the system. 


7. State — The status of each job is determined by the operation being 
performed. For example, the SYSTAT job’s status is RN Lck. This means that 
the job is running or waiting to run (RN), and that it is locked in memory 
(Lck) during the SYSTAT operation. The SYSTAT operation is completed 
when the display appears at your terminal and is followed by the DCL 
prompt, which shows that your job is no longer locked in memory. 


8. Run-Time — The system keeps track of the CPU time each job uses. For 
example, the BACKUP job has used a total of 8 minutes and 13 seconds of 
CPU time. 


9. RTS (Run-Time System) — RSTS/E provides a variety of run-time systems, 
including DCL and null RTS (shown on the display as "...RSX"). 


Table 4—2 shows the elements you may find in a system status display. You 
might want to refer to this table when you use the SHOW USER or SHOW JOB 
commands. 
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Table 4-2: SHOW USER and SHOW JOB Abbreviations 


Abbreviation 


DET 


* 


RK KK 
> 


RN 
RS 


BF 


HB 


AG 


CR 


MT, MM, or MS 
LP 


DT 


DK, DM, DB, DP 
DL, DR, DU 


DX 


RJ 


Meaning 


Detached 
Dialup 


Description 


Where Column 


Job is detached from all terminals. 


Job is running over a dialup line. 


Who Column 


Job is not logged in to the system. 


State Column (Job Status) 


Run 
Residency 
Buffers 


Sleep 


Send/Receive 


File Processor 


Terminal 


Hibernating 


Keyboard 
Ctrl/C 


Card Reader 


Magnetic tape 
Line Printer 


DECtape 
Disk 


Flexible Diskette 


RJ2780 


Job is running or waiting to run. 


Job is waiting for residency. (The job 
has been swapped out of memory and is 
waiting to be swapped back in.) 


Job is waiting for buffers (no space is 
available for /O buffers). 


Job is sleeping (SLEEP statement). 


Job is sleeping and is a message re- 
ceiver. 


Job is waiting for file processing by the 
system (opening or closing a file, file 
search). 

Job is waiting to perform output to a 
terminal. 


Job is detached and waiting to perform 
I/O to or from a terminal. (Someone 
must attach to the job before it can 
resume execution.) 


Job is waiting for input from a terminal. 


Job is at command level, awaiting 
a command. (In other words, the 
keyboard monitor has displayed its 
prompt and is waiting for input.) 


Job is waiting for input from a card 
reader. 


Job is waiting for magnetic tape I/O. 


Job is waiting to perform line printer 
output. 


Job is waiting for DECtape I/O. 
Job is waiting to perform disk I/O. 


Job is waiting to perform flexible 
diskette I/O. 


Job is waiting for RJ2780 I/O. (The 
RJ2780 is a device for communicating 
with an IBM system.) 


(continued on next page) 
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Table 4-2 (Cont.): 


Abbreviation 


2? 


+ Or - 


Leck 


Nsw 


Swi 


Swo 


xnn 


BASIC 
BASIC2 
DCL 


RT11 
RSX 
. RSX 


Meaning 


SHOW USER and SHOW JOB Abbreviations 


Description 


State Column (Job Status) 


Temporary Privileges 


Job’s state cannot be determined by the 
SHOW command. 


Job has temporary privilege. A plus 
sign (+) means that the temporary 
privilege is active. The minus sign (-) 
means that the program has temporary 
privilege, but that it is not active. 


The following status descriptions may appear after 
one or more of the other job state abbreviations: 


Locked 


No Swapping 
Swapping In 


Swapping Out 


Job is locked in memory for the current 
operation. 


A program has requested that the job 
not be swapped from memory. 


Job is currently being swapped into 
memory. 


Job is currently being swapped out of 
memory. 


Job is swapped out and occupies slot nn 
in swap file X; file is denoted by A, B, 
C, or D to represent files 0 through 3 of 
the swapping structure. For example, 
A13 means slot 13 of swapping file 0 
(SWAPO.SYS). 


RTS Column (Run-time System) ' 


BASIC 
BASIC-PLUS-2 
DCL 


The BASIC-PLUS run-time system. 
The BASIC-PLUS-2 run-time system. 


The Digital Command Language (DCL) 
keyboard monitor. 


The RT11 run-time system. 
The RSX run-time system. 


"Null RTS," meaning the monitor is 
executing your job directly without 
using a run-time system. 


1 Any run-time system available on your system may appear in this column. Some of the most 
commonly used run-time systems are listed here. 


4.2.1 Attached and Detached Jobs 


Some of the command displays of system status involve attached and detached 
jobs. An attached job is one that is associated with a terminal, and thus allows 
user input. By contrast, a detached job on RSTS/E is used to perform various 
system functions, such as printing files on the line printer. 
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For example, suppose the system manager invokes a program at system start-up 
time to keep track of jobs that run through any queue on the system. RSTS/E 
considers that job to be detached, because it is not associated with a specific 
terminal. 


You may not recognize the names of programs that are run by detached jobs. 
They need not be standard RSTS/E programs—some could be created at your 
site. In addition, some of these programs are used primarily by the system 
manager. Programs for system management are described in the RSTS/E System 
Manager’s Guide. 


The following is an example of a display produced by the SHOW USER/ALL 
or SHOW JOB/ALL commands. Note that both attached and detached jobs are 
displayed: 


RSTS V10.0-L status at 09-Jun-90, 05:50 PM Up: 6:22:34 


Job Who Where What Size State Run-Time Pri/RB RTS 
1 1,2 Det ERRCPY 11/64K SR A40 10.2 0/6 6«4RSK 
2 ce Det OPSRUN 22/64K SL 2:44.7 -8/6 Sip Seo 
4 1,196 KB30 DCL 4/64K ie 9:39.4 -8/6 DCL 
7 i re Det QUMRUN 24/64K SL 1404.5 0/6 Meee og 
12 1,217 Pi1dJdi17 DCL 14/64K RN 8:52.8 --16/6 DCL 
15 1,214 KB26 SYSTAT 20/64K RN Leck 5.2 -8/6 «KG ROO 
17 12 Det PBS... 18/64K SL 6:00.0 -8/6 iene 
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4.2.2 SHOW USER 


Format 


The SHOW USER command displays information about the status of jobs on the 
system. 


SHOW USER _//p,pn/]] 


Command Qualifiers Defaults 
/ALL none 
/ATTACHED none 
/DETACHED none 
/[NOJOUTPUT[=filespec] none 
/TERMINAL=KBn: none 


Command Parameters 
[[p,pn]] 


Specifies the account whose jobs are to be displayed. If you do not specify an 
account, the SHOW USER command displays all attached jobs on the system. 


Command Qualifiers 


/ALL 
Specifies that all jobs, both attached and detached, be displayed. 


/ATTACHED 
Specifies that only attached jobs be displayed. 


/DETACHED 
Specifies that only detached jobs be displayed. 


/OUTPUT[=filespec] 

/NOOUTPUT 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 


/TERMINAL=KBn: 
Specifies that only the job logged in at a particular terminal be displayed. 
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4.2.3 SHOW JOB 


Format 


The SHOW JOB command, like SHOW USER, also displays information about 
the status of jobs on the system. This command is more convenient, however, for 
quickly showing the status of only your own job. 


SHOW JOB _[job-number] 


Command Qualifiers Defaults 
/ALL none 
/ATTACHED none 
/DETACHED none 
/[NOJOUTPUT[=filespec] none 
/TERMINAL=KBn: none 


Command Parameters 


job-number 
Specifies the the job number to be displayed. If you do not specify a job number, 
the SHOW JOB command displays only your own job. For example: 


eS O lire (6. ee ee 
$ eSBs wr SA 


5 1,214 KB26 SYSTAT 20/64K RN Leck 4.2 -8/6 4 -eo 


Command Qualifiers 


/ALL 
Specifies that all jobs, both attached and detached, be displayed. 


/ATTACHED 
Specifies that only attached jobs be displayed. 


/DETACHED 
Specifies that only detached jobs be displayed. 


/OUTPUT[=filespec] 

/NOOUTPUT 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 


/TERMINAL=KBn: 
Specifies that only the job logged in at a particular terminal be displayed. 
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4.2.4 CTRL/T 


In addition to using the SHOW JOB command, you can get a quick one-line 
status report on your current job by pressing Ctrl/T. When you press Ctrl/T, 
RSTS/E displays a report similar to the following: 


18 


GARP::KB32 TEST+BAS4F KB(OR) 11(16)K+16K 3.3(+.5) 


The report shows: 


Your current job number (for example, 18) 
The node name of your system (for example, GARP) 
The keyboard number of your terminal (for example, KB32) 


The name of the program or operation you are currently running (for example, 
TEST) 


The current run-time system name (for example, BAS4F) 
The current job state (for example, KB(OR)) 


The current program size in K-words (for example, 11). If two numbers 
appear in this field (for example, 4+10), it represents the instruction size and 
the data size or a split I & D space task. 


The maximum program size in K-words (for example, (16)K) 
The run-time system size in K-words (for example, +16K) 
The amount of CPU time in seconds your job has used (for example, 3.3) 


The amount of time the job has run since the last Ctrl/T (for example, (+.5)) 


4-10 System and Account Operations 


4.2.5 SHOW PORT 


Format 


This command displays the characteristics of LAT ports on the RSTS/E node. 
By default, both interactive and application ports are displayed. The infor- 
mation shown includes the local port name, the port type (either Interactive 
or Application) and the default queued setting (either Queued or Nonqueued), 
the terminal server name, the remote service (if specified), the remote port (if 
specified) and the connection status. 


If the port is not assigned to a terminal server, only the local port name and 
type are displayed. If the port is assigned but not yet connected, the requested 
terminal server, remote service, and remote port are shown. If the port is 
waiting to connect, the connection status "In Progress" is shown; if the connection 
is queued, the queue position is also displayed. If the port is connected, the 
terminal server, the remote service and the remote port to which it is actually 
connected are shown, and the job number is displayed. Example: 


S$ SHOW PORT 


Port Type Terminal Server Remote Service Remote Port Connect Status 


KB1 A,Q SERVER_1 SERVICE A PORT 1 Connected, Job=3 
KB2 A,NQ SERVER_1 PORT 1 Not connected 
KB3 A,Q SERVER 2 SERVICE C In Progress 

KB4 A,Q SERVER 2 SERVICE C PORT 2 Queue Pos=1 

KB5 A,NQ Not Assigned 

KB6 I,NQ SERVER 3 TWA55 Connected, Job=1 
KB7 I,NQ SERVER 3 TWA56 Connected, Job=2 


A=Application Port I=Interactive Port Q=QUEUED NQ=NOQUEUED 


SHOW/PORT _[port-name] 


Command Qualifiers Defaults 
/ALL /ALL 
/[NOJAPPLICATION none 
/[NOJINTERACTIVE none 
/LAT /LAT 
/[NOJOUTPUT[=filespec] your terminal 

Prompts 

none 


Command Parameters 


port-name 

Specifies the name of the local port for which characteristics will be displayed. 
The port_name must be in the form of KBIn: or KBn: where n is a value from 0 
through 127. If a port_name is not specified, the characteristics for all ports are 
shown. 
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Command Qualifiers 


/ALL 
Generates a display of all LAT ports, both application and interactive. The 
default is /ALL. 


/[NOJAPPLICATION 

Generates a display of all LAT application ports. This qualifier is ignored if a 
port_name is specified. If /NOAPPLICATION is specified, only interactive ports 
are displayed. 


/[LNOJINTERACTIVE 

Generates a display of all LAT interactive ports. This qualifier is ignored if a 
port_name is specified. If /NOINTERACTIVE is specified, only application ports 
are displayed. 


/LAT 
Indicates that LAT ports are to be displayed. The default is /LAT. 


/[[NOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on your terminal. 
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4.2.6 SHOW SYSTEM 


The SHOW SYSTEM command displays the default characteristics of the system. 


For example: 


System name: 


Currently installed Monitor: 


Swap Maximum: 

Date format: 

Time format: 

Magtape label default: 
Magtape density default: 
Power fail restart delay: 
Dynamic Region Limit: 
Hangup: 

Monitor Statistics: 

Job limit: 

Current jobs: 

Password Prompting: 


Last System Password change: 


LAT Software: 

FMS Software: 

Current Pseudo keyboards: 
Answerback message: 


Format 


SHOW SYSTEM 


Command Qualifiers 
/EMT_LOGGING 
/[NOJOUTPUT[=filespec] 


RSTS V10.0-L BSRTD:: 
V1OLAT 

66K 

Alphabetic 

AM PM 

DOS 

800 BPI 

300 seconds 

OK words 

Delayed 

Enabled 

45 

37 

All users 

02-Jul-90 at 02:21 PM 
Installed 


10 
None 


Defaults 


none 
none 


Command Qualifiers 


/EMT_LOGGING 


Displays the status of each EMT loggable. 


/OUTPUT[=filespec] 


/NOOUTPUT 


Upon reboot: 
Not Installed Upon reboot: 


Not installed 
installed 


Writes the information to the specified file. If you specify /(NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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4.2.7 SHOW ACCOUNT 


Format 


The SHOW ACCOUNT command displays data about an account. 


SHOW ACCOUNT [device-name:[p,pn]] 


Command Qualifiers Defaults 
/ACCOUNTING_DATA See discussion 
/BRIEF /BRIEF 

/FULL /BRIEF 
/[NOJOUTPUT[=filespec] See discussion 


Command Parameters 


device-name:|[p,pn] 
Specifies the disk and account to be displayed. If you do not specify the disk, the 
default is SY0:; if you do not specify account, the default is your own PPN. 


Command Qualifiers 


/ACCOUNTING_DATA 

/BRIEF 

/FULL 

Specifies the amount or type of information to be displayed about the account. 


If you specify /ACCOUNTING_DATA, RSTS/E displays accounting information 
only. For example: 


S SHOW ACCOUNT/ACCOUNTING DATA <RET> 
Account Name Allocation KCT CPU-Time Connect Device 


[1,214] 4692 1041124 0124032753 91 e2d 02:48 


If you specify /BRIEF (the default), RSTS/E displays brief general information 
about your account. For example: 


$ SHOW ACCOUNT <RET> 
Account Name Allocation IDNCLP Last Login Expires 
[1,214] 4692 IDN P KB2: 19-Jun-90 10:48 AM 
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If you specify /FULL, RSTS/E displays complete information about your account. 
For example: 


_SY¥: [52,20] Account Display RSTS Vi0-7.0-L, BSRID: 


03:27 PM on 19-Jun-90 


_S8Y¥:[52,20] "Mary Smith" Created: 26-May-87 


Privileges: DATES DEVICE EXQTA GACNT GREAD GWRITE HWCFG HWCTL INSTAL 
JOBCTL MOUNT OPER PBSCTL RDMEM RDNFS- SEND SETPAS SHUTUP 
SWCFG SWCTL SYSIO SYSMOD TMPPRV TUNE USER1 WACNT WREAD 


WRINFS WWRITE 


Attributes: INTERACTIVE DIALUP NETWORK NOCAPTIVE 
NOLOOKUP PASSWORD PROMPT NOEXP IRE 
Quotas: Disk usage - Logged out: unlimited Logged in: unlimited 
Job limits - Detached: 10 Total: unlimited 
Send/Receive - RIB: 1 Message: unlimited 
Accounting: CPU Time: 48:22:55.1 Kilo-Core Ticks: 41949386 
Device Time: 40:57 UFD Clustersize: 16 
Connect Time: 219:44 UFD Size: Z 
Blocks allocated: 2464 UFD Used: 9.8% 


Last Password change on 01-Jun-90 at 06:06 PM 
Last interactive login on KB61: on 19-Jun-90 at 08:00 AM 
Last non-interactive login on 12-Jun-90 at 05:00 PM 


/OUTPUT[=filespec] 
/NOOUTPUT 
Writes the information to the specified file. If you specify /NOOUTPUT, the 


information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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4.3 SET 


Use SET and an option to define or change certain default characteristics, such 
as the default protection codes the system assigns to your files. 


Format 
SET option 
Table 4-3 lists the options that you can use with the SET command. 


Table 4-3: SET Command Options 


Option Function 

ENTRY Modifies an entry on a print or batch queue. See Chapter 7 for more 
information. 

FILE Specifies the characteristics of a file. See Chapter 3 for more 
information. 

HOST Specifies the network node to connect your terminal to, so you can 
log in to that node. See Chapter 1 for more information. 

LOG_FILE Selectively enables or disables output to a log file that you previ- 


ously opened with the OPEN/LOG_FILE command. See Chapter 5 
for more information. 


PASSWORD Lets you change your password. See this chapter for more informa- 
tion. 

PROMPT Lets you change your prompt text. See this chapter for more 
information. 

PROTECTION Determines the protection code of a file. See Chapter 3 for more 
information. 

TERMINAL Specifies the characteristics of a terminal. See Chapter 5 for more 
information. 

NOTE 


The following SET options are used in command procedures. See the 
RSTS/E Guide to Writing Command Procedures for more information 
on how to use these options 


[NOJCONTROL=C = Controls CTRL/C checking within a command procedure. 


[NO]JDATA Controls whether DCL reads data required by a program or a 
command from your terminal, rather than from a command file. 

[NOJECHO Controls whether terminal output is enabled or disabled during 
command procedure execution. 

[NOJON Controls error checking within a command procedure. 

[NOJVERIFY Controls whether DCL command lines are displayed during com- 


mand procedure execution. 


4-16 System and Account Operations 


4.3.1 SET PASSWORD 


Format 


The SET PASSWORD command lets you change your own password at any time 
to provide a greater level of protection against unauthorized users of the system. 
To maintain secrecy, you should change your password frequently. 


Usually, all users are granted the privilege to do this; however, in some cases 
the system manager may restrict which users have the right to change their 
passwords. 


SET PASSWORD device-name:!p,pn] 


Command Qualifiers Defaults 
/[NO]LOG /LOG 
Prompts 


Old password: old password 
New password: new password 
New password again, for verification: new password 


Command Parameters 


device-name:[p,pn] 
Specifies the disk and account for which the password is to be changed. Unless 
you have sufficient privileges, you can only change your own account’s password. 


If you do not specify the disk, the default is SY0:; if you do not specify an account, 


the default is your own PPN. 


Command Qualifiers 


/LOG 

/NOLOG 

Specifies whether the following message, confirming that the password was 
changed, displays: 


Password set for account dev: [PPN]. 
The default is /LOG. 


Passwords can contain from 6 to 14 characters. The characters can be in 
uppercase, lowercase, or a combination. Valid characters are: 


° A through Z 
¢ a through z 
¢ 0 through 9 


e Any printable character (for example, $, *,#, +, ), including spaces, except the 
question mark (?) character. 
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Digital recommends the following guidelines to minimize the chances that 
unauthorized users can discover your password either by trial and error guessing 
or a systematic search: 


¢ Do not use names or words that could be readily associated with any user (for 
example, WRITER, GUEST, or any part of your name). 


e Change your password at least once a month. 


When you type your password, RSTS/E does not display (echo) your input; this 

helps ensure secrecy. To protect against typing errors that you cannot see when 
you enter your new password, you must type the new password twice. If you do 
make an error, an error message displays and the password remains unchanged. 


NOTE 


In some cases, the system manager may have modified your account 
with a special qualifier (LOOKUP). If so, you will not be able to use 
a password over six characters long, and you can only use letters and 
digits. See your system manager if you have trouble changing your 
password. 


4-18 System and Account Operations 


4.3.2 SET PROMPT 


Format 


The SET PROMPT command allows you to change your prompt text. The prompt 
can be an expression or a quoted string. The maximum length allowed is 255 
characters. 


SET PROMPT [prompt] 


Command Qualifiers Defaults 
/LOG_FILE none 


Command Qualifiers 


/LOG_FILE 
Enables the specified prompt only while logging your terminal session. 
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4.4 REQUEST 


Format 


The REQUEST command displays a message at all operator terminals. 


REQUEST [ “/message[”] 


Command Qualifiers Defaults 
/PROMPT none 
/[NO]REPLY[=DCL-symbol-name] /REPLY 
/[NO]TIME_OUT[=wait-minutes] See discussion 


When you use the REQUEST command to send a message to an operator, the 
message is displayed at all defined operator terminals. 


Command Parameters 


message 
Specifies the text of a message to be displayed at operator terminals. For 
example: 


S$ REQUEST "Do we need more paper for the line printer?" <RET> 


The command can have a maximum length of 255 characters. 


Command Qualifiers 


/PROMPT 

Causes you to be prompted for multiple lines of text that will make up the text 
of the request. The text is entered in a manner similar to the CREATE and 
BROADCAST commands. The length of this request text can have a maximum of 
500 characters. This qualifier conflicts with the request-text parameter, and will 
cause an error if both are specified on the same command line. 


/[NO]JREPLY[=DCL-symbol-name] 

Indicates whether a reply is expected. /REPLY indicates that a reply is required. 
The job will be placed in a wait state until an operator replies to the request, 

or the user types Ctrl/C to cancel the request. The optional [DCL-symbol-name] 
indicates the text of the operator’s reply will be placed in the specified DCL 
symbol. You can specify /LOCAL or /GLOBAL to indicate whether the symbol 
should be placed in the local symbol table or the global symbol table. The default 
is /LOCAL. 


/NOREPLY indicates that no reply is expected, and control returns to DCL after 
the REQUEST has been sent. 


/[NO]TIME_OUT[=wait-minutes] 

Specifies the length of time (in minutes) to wait for a reply. If no reply is given 
after the amount of time specified, the request will be canceled and control 
returned to DCL. You can specify any integer in the range 1-255. By default, 
there is no time limit imposed on the REQUEST command. 
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Chapter 5 


Terminal Status and Operations 


This chapter describes various operations you perform on your terminal, including 
the following: 


e Displaying and setting terminal characteristics 

¢ Creating a log file of a terminal session 

Use the SHOW TERMINAL command to display information about your terminal 
and the SET TERMINAL command to change that information. Use the 
OPEN/LOG_FILE and CLOSE/LOG_FILE commands to begin and end terminal 


logging to a file, and the SET LOG_FILE command to selectively enable and 
disable logging within the log file. 


5.1 Displaying and Setting Terminal Characteristics 


The SHOW TERMINAL command, described in this chapter, produces a display 
similar to the following: 


S$ SHOW TERMINAL <RET> 


Terminal: KB56: Device Type: VT220 
Break No Broadcast Control=(R,T,C,X) CRFil1=0 
No Delimiter Eight Bit No Form Hostsynec 
Interactive Lowercase Resume=Control C Scope 
Speed not settable Tab TTSyne Width=80 


Now, suppose you want to change the No Broadcast characteristic (which prevents 
messages from other users from appearing on your terminal) to Broadcast (which 
allows these messages). You use the following SET TERMINAL command to 
change this characteristic: 


$ SET TERMINAL/BROADCAST <RET> 


This change (replacing "No Broadcast" with "Broadcast") is now shown in the 
SHOW TERMINAL display: 


S$ SHOW TERMINAL <RET> 


Terminal: KB56: Device Type: VT220 
Break Broadcast Control=(R,T,C,X) CRFil1=0 
No Delimiter BEignt Bit No Form Hostsync 
Interactive Lowercase Resume=Control C Scope 
Speed not settable Tab Trsyne Width=80 


Many of these characteristics (such as CRFill=n, Parity, and TTYSYNC) need 
to be set only once for the terminal, so you may never need to reset them. 
Usually the system manager sets these characteristics when the terminal 

is first connected to the system. However, characteristics such as Broadcast 
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and Width=n depend on your preference for using the terminal. See the SET 
TERMINAL command in this chapter for a description of characteristics you can 
set. 


There are no true "default" characteristics. That is, if you do not. specify a 
characteristic, it is either implied by a terminal type (such as /VT100), or it 
remains constant when you change other settings. A terminal characteristic 
remains the same unless you either change it or specify a different terminal 
type. The SET TERMINAL command description lists the terminal types you can 
specify. 

Although RSTS/E assigns a set of predefined characteristics for each specific 
terminal type, you can reset any of these characteristics. For example, suppose 
you type: 

$ SET TERMINAL/DEVICE TYPE=VT240 <RET> 

RSTS/E now assumes that your terminal has a set of characteristics that 


correspond to a VT240. You can check these characteristics with the SHOW 
TERMINAL command, and change them if you want. 


5.1.1 SHOW TERMINAL 


Format 


The SHOW TERMINAL command displays the current or permanent charac- 
teristics of a terminal. Each of these characteristics can be changed with a 
corresponding option of the SET TERMINAL command. If the terminal is in use 
as a LAT port connected to a terminal server, then the name of the server, service 
and remote port are also displayed. 


NOTE 


The SHOW TERMINAL command has additional capabilities for users 
with greater levels of privilege. See the RSTS/E System Manager's 
Guide for more information. 


SHOW TERMINAL /[KB/[CJnf[:]] 


Command Qualifiers Defaults 

/ALL /ALL 

/BRIEF /BRIEF 

/FULL /BRIEF 
/[NOJOUTPUT[=filespec] See discussion 
/[NOJPERMANENT /NOPERMANENT 


Command Parameters 
[KB[C]n{:]) 


Specifies the terminal whose characteristics are to be displayed. Unless you 
have additional privilege to specify other terminals, you can only display the 
characteristics of your own terminal. 
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Command Qualifiers 


/ALL 
Displays the characteristics of all terminals on the system. 


/BRIEF 

Specifies a brief display; it is the default. For example: 

Terminal: KB46: Device Type: VT220 LAT Interactive Port 

LAT Server/Port: JTSVAX/TWA7 
Break Broadcast Control=(R,T,C,X) CRFil1=0 
No Delimiter Eight Bit No Form Hostsync 
Interactive Lowercase Resume=Control C Scope 
Speed not settable Tab TTSyne Width=80 

/FULL 


Specifies a display showing additional characteristics. For example: 


oy ee ie a 
a Pg 


Terminal: KB46: Dévice. Type: VIZ20 LAT Interactive Port 
LAT Server/Port: JTSVAX/TWA7 


132 Columns Advanced Video No Alt Mode ANSI 

No Answerback No Autobaud Break Broadcast 

Buffer Quota=168 Control=(R,T,C,X) CRFi11=0 No Delimiter 

No Dialup Bight Bit Escape Sequence No Form 

Hostsynec Interactive No Katakana Line éditing 

No Loadable Characters No Local Echo Lowercase 

No Operator Overstrike No Parity No Printer Port 
Recall Regis Restricted Resume=Control C 
Scope Select Erase Sixel Speed not settable 
Tab TTSyne Up Arrow User Defined Keys 
Width=80 


/OUTPUT[=filespec] 

/NOOUTPUT 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 


/PERMANENT 

/NOPERMANENT 

Specifies whether the display shows the permanent characteristics set for your 
terminal by the system manager. The default is /(NOPERMANENT, showing the 
characteristics you have set for the current terminal session. When you logout, 
RSTS/E resets your terminal to the permanent characteristics. 
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5.1.2 


Format 


SET TERMINAL 


The SET TERMINAL command lets you specify the characteristics of your 


terminal. 


The SET TERMINAL command has additional capabilities for users 
with greater levels of privilege. See the RSTS/E System Manager’s 


Guide for more information. 


SET TERMINAL /KB[C]n[:]] 


Command Qualifiers 
/[NO]132_COLUMNS 
/[NOJADVANCED_ VIDEO 
/[NOJALT_MODE 

/[NOJANSI 

/[NO]BREAK 
/[NO]JBROADCAST 
/[NO]CONTROL=[(option[, option,...])] 
/[NO]CRFILL[=n] 
/[NO]DELIMITER[=c] 
/DEVICE_TYPEsterminal type 
/[NOJEIGHT_BIT 
/[NOJESCAPE_SEQUENCE 
/[NO]FORM_FEED 
/HARDCOPY 

/SCOPE 

/[NOJHOSTSYNC 

/INQUIRE 

/JINSERT 

/OVERSTRIKE 
/[NO]KATAKANA 
/[NO]LINE_EDITING 
/[NOJLOADABLE_CHARACTERS 
/[NO]JLOCAL_ECHO 
/LOWERCASE[=INPUT | OUTPUT] 
/[NO]PARITY[=option] 
/[NO]JPRINTER_PORT 
/[NO]JRECALL 

/[NO]JREGIS 

/RESET 
/RESUME=[ANY | CONTROL_C] 
/[NO]JSELECT_ERASE 
/SETUP=filespec 

/[NO]SIXEL 

/SPEED=(input{[, output)] 
/[NO]TAB 

/[NO]TTSYNC 
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NOTE 


Defaults 

none 

none 

none 

none 

none 

none 

none 
/NOCRFILL 
none 

See discussion 
none 

none 

none 

See discussion 
none 

none 

none 
/OVERSTRIKE 
/OVERSTRIKE 
none 

none 

none 

none 

See discussion 
none 

none 

none 

none 

See discussion 
none 

none 

none 

none 

none 

none 

none 


/TYPE=n none 


/[NO]JUP_ARROW none 
/UPPERCASE[=INPUT | OUTPUT] See discussion 
/[NOJUSER_DEFINED_ KEYS none 
/WIDTH=n none 


Command Parameters 


[KBn{[:]] 

Specifies the terminal whose characteristics are to be set. Unless you have 
sufficient privilege to specify other terminals, you can only set the characteristics 
of your own terminal. 


Command Qualifiers 


/132_COLUMNS 

/NO132_COLUMNS 

Specifies whether the terminal can display single-width characters in an array of 
24 lines by 132 columns. 


/ADVANCED_VIDEO 

/NOADVANCED_ VIDEO 

Specifies whether the terminal supports the Advanced Video Option (AVO), which 
includes additional character attributes, screen memory, and ROM sockets. 


/ALT_MODE 

/NOALT_MODE 

Specifies whether the system treats ASCII 027, 125, and 126 as ESCAPE. If you 
specify /NOALT_MODE, the system treats only ASCII 027 code as ESCAPE. 


/ANSI 

/NOANSI 

Specifies whether the terminal supports ANSI escape sequences. ANSI is 
required for Command Line Editing. 


/BREAK 

/NOBREAK 

Specifies whether the system translates the BREAK key as a CTRL/C character 
(Binary 3). If you specify /NOBREAK, the system translates the BREAK key as a 
NULL character (Binary 0). 


/BROADCAST 
/NOBROADCAST 
Specifies whether the terminal receives system broadcast messages. 


/CONTROL=[(option[,option.,...])] 
/NOCONTROL=[(option[,option.,...])] 
Specifies the following: 


/CONTROLER Indicates Ctrl/R will redisplay the command line. 
/NOCONTROL=R Means that Ctrl/R is interpreted as data. 


/CONTROLST Indicates that Ctrl/T will give a one line staus report. 
/NOCONTROL=T Means that Ctrl/T is interpreted as data. 
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/CONTROL=C means that Ctrl/Cs are trapped and handled. 
/NOCONTROL=C means that Ctrl/C is interpreted as data. 


/CONTROL=X means that Ctrl/X clears the type-ahead buffer. 
/NOCONTROL=X means that CtrlI/X is interpreted as data 


To set more than one of these options on a single command line, you can combine 
them in a list. For example: 


SET TERMINAL/CONTROL= (R,T,C) 


/CRFILL[=n] 

/NOCRFILL 

Specifies the carriage return fill factor, where n is between 0 and 6. The default 
is /NOCRFILL, meaning that no fill characters are generated. 


/DELIMITER[=c] 

/NODELIMITER 

Specifies a private delimiter. If the argument is a character within quotation 
marks (for example, /DELIMITER= “.<tab>”), that character becomes the private 
delimiter. 


If the argument is a number (for example, /DELIMITER=9), the private delimiter 
becomes the character whose binary value matches that number. Thus, any 
ASCII character whose binary value is between 1 and 127 can be a private 
delimiter. 


The /NODELIMITER qualifier cancels any private delimiter previously set with 
/DELIMITER. 


/DEVICE_TYPE=terminal type 
Sets the default characteristics for the specified terminal type. The following 
terminal types can be specified with this qualifier: 


LA12 LA75 LA324 VT52 VT105 VT240 

LA34 LA100 LNO3 VT55 VT125 VT241 

LA36 LA120 LQP02 VT100 VT131 VT320 

LA38 LA180S LQP03 VT101 VT132 VT330 

LA50 LA210 VK100 VT102 VT220 VT340 
NOTE 


You can specify the following terminal types without explicitly using 
the /DEVICE_TYPE qualifier: LA34, LA36, LA38, LA120, VT52, or 
VT100. 


/EIGHT_BIT 
/NOEIGHT_BIT 
Specifies whether the terminal supports eight bit characters. 


/ESCAPE_SEQUENCE 

/NOESCAPE_SEQUENCE 

Specifies whether the system treats an ESC character (value 27) as an indication 
of an incoming escape sequence. The system does not echo either the ESC 
character or the characters in the sequence. 


If you specify /(NOESCAPE_SEQUENCE, the system treats the ESC character as 
a line terminator and echoes it as a dollar sign ($) character. 
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/FORM_FEED 

/NOFORM_FEED 

Specifies whether the hardware form feed and vertical tab control are enabled. 
The system transmits form feed and vertical tab characters without translation. 


If you specify /NOFORM_FEED, the hardware form feed and vertical tab control 
are disabled. The system transmits four line feed characters in place of a form 
feed or vertical tab character. 


/HARDCOPY 

/SCOPE 

Specifies whether the terminal is a hardcopy or a CRT display device. If you 
specify /HARDCOPY, then /NOTTSYNC is set by default. 


If you specify /SCOPE, then /TTSYNC is set by default. 


/HOSTSYNC 

/NOHOSTSYNC 

Specifies whether the terminal has special hardware that lets the computer 
interrupt character transmission by sending an XOFF character (Value 19) to the 
terminal. The computer instructs the terminal to resume character transmission 
by sending an XON character (Value 17) to the terminal. /HOST_SYNC conflicts 
with /RESUME=ANY. 


/INQUIRE 

Interrogates the terminal by sending an ANSI ESCAPE identifying sequence 
to determine the terminal type. The system then sets the appropriate terminal 
characteristics. 


If the terminal does not respond within five seconds, the system searches the 
default file $TERDFL.SYS for the terminal’s default characteristics. If an entry 
is found, the system sets the specified characteristics; if no entry is found, the 
system displays an error message. 


This qualifier causes the terminal’s type-ahead buffer to be cleared. 


You should only use the (INQUIRE qualifier on Digital terminals. (However, 
Digital does not support it on LA36 terminals.) 


/[INSERT 

/OVERSTRIKE 

Allows you to insert characters (INSERT mode) when editing a command line or 
type over the current character (OVERSTRIKE mode). This mode becomes the 
default whenever a new command is entered. See Chapter 1 for more information 
on command line editing. 


/KATAKANA 
/NOKATAKANA 
Specifies whether the terminal supports the Katakana character set. 


/LINE_EDITING 

/NOLINE_ EDITING 

Enables or disables line editing capabilities on the terminal. This qualifier is 
valid only at the application level; it is ignored at the DCL level or at other 
run-time systems levels. See Chapter 1 for more information on command line 
editing. 
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/LOADABLE_CHARACTERS 

/NOLOADABLE_CHARACTERS 

Specifies whether the terminal supports dynamically redefinable character sets, 
allowing the terminal to load fonts that can then be invoked as a character set. 


/LOCAL_ECHO 

/NOLOCAL_ECHO 

The /LOCAL_ECHO qualifier specifies that the system does not echo characters 
received from the terminal. This qualifier is used only for terminals that have 
their own local echo. 


If you specify /NOLOCAL_ECHO, characters are sent to the system, which echoes 
each character received and translates certain characters as to their action. For 
example, the CR character echoes as a carriage return and line feed sequence. 


/LOWERCASE[=INPUT | OUTPUT] 
/UPPERCASE[=INPUT | OUTPUT] 
Specifies the following: 


/LOWERCASE enables lowercase for input and output. 
/UPPERCASE disables lowercase for input and output. 


/LOWERCASE=INPUT enables lowercase for input. 
/LOWERCASE=OUTPUT enables lowercase for output. 


/UPPERCASE=INPUT disables lowercase for input. 
/UPPERCASE=OUTPUT disables lowercase for output. 


If you specify /LOWERCASE or /LOWERCASE=INPUT, then /NOALT_MODE 
is set by default. If you specify /UPPERCASE or /UPPERCASE=INPUT, then 
/ALT_MODE is set by default. 


/PARITY[=option] 

/NOPARITY 

Specifies whether EVEN or ODD parity option is set, in which case the system 
sends characters to the terminal with the parity bit set for either even or odd 
parity, but ignores the parity bit on characters received. 


If you specify /NOPARITY, the system ignores the parity bit on characters it 
receives and treats the parity bit on characters it transmits to the terminal as a 
data bit. 


/PRINTER_PORT 
/NOPRINTER_PORT 
Specifies whether the terminal has a printer port. 


/RECALL 
/NORECALL 
Enables or disables command recall capabilities on the terminal. 


/REGIS 

/NOREGIS 

Specifies whether the terminal supports the Remote Graphic Instruction Set 
(ReGIS). 
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/RESET 

Resets the terminal’s characteristics, if you have changed them, back to the 
permanent set of characteristics that the system manager originally assigned for 
that terminal. 


/RESUME=[ANY | CONTROL_C] 

Defines XON/XOFF processing. The argument ANY enables typeout and echo 
when you type any character after XOFF. The argument CONTROL_C en- 
ables typeout and echo only when XON or Ctrl/C are entered after XOFF. 
/RESUMEE=ANY is not valid if the terminal is set /HOST_SYNC. 


/SCOPE 
Specifies the terminal is a CRT display. 


/SELECT_ERASE 

/NOSELECT_ERASE 

Specifies whether the terminal supports the selectively erasable character 
attribute. 


/SETUP=filespec 

Sends the specified file’s data, in binary mode, to the terminal. If you specify 
the file name alone, the system assumes the file is in the user’s account on the 
system disk with a file type of .ESC. 


Use this qualifier to initialize a terminal for which special software settings must 
be made. 


/SIXEL 

/NOSIXEL 

Specifies whether the terminal supports Sixel Graphics, which transfers binary 
graphic images between the system and the terminal or the terminal and a 
printer. 


/SPEED=(input[,output)] 
Specifies the speed at which the terminal sends or receives data or both. If you 
specify only one speed, RSTS/E uses that speed for both input and output. 


/TAB 

/NOTAB 

Specifies whether hardware tab control is enabled. The system transmits tab 
characters without translation. 


If you specify /NOTAB, hardware tab control is disabled. To move to the next tab 
stop, the system transmits the correct number of space characters instead of the 
tab character. 


ITTSYNC 

/NOTTSYNC 

Specifies whether the system responds to the Ctrl/S combination (XOFF) by 
interrupting character transmission and to the Ctrl/Q combination (XON) by 
resuming character transmission. 


If you specify /NOTTSYNC, the Ctrl/S and Ctrl/Q combinations have no special 
meaning. 


/TYPE=n 

Sets the value of the terminal’s type code, which identifies the terminal type in 
the SHOW TERMINAL display. Values 0-127 are reserved for Digital terminals. 
Values 128-255 can be used to identify other terminals. 
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/UP_ARROW 
/NOUP_ARROW 


Specifies whether the system echoes a control and graphic character combination 
as the circumflex (*) character (Value 94), followed by the proper graphic. For 
example, Ctrl/E prints out as “E. 


If you specify /NOUP_ARROW, the system echoes control and graphic character 
combinations as is. 


/UPPERCASE[=INPUT | OUTPUT] 
Disables use of lowercase character for terminal INPUT and/or OUTPUT. 


/USER_DEFINED_KEYS 

/NOUSER_DEFINED_KEYS 

Specifies whether the terminal supports User Defined Keys (UDKs), which let you 
save a full command string and invoke it with a single key. 


/WIDTH=n 
Sets the width of the terminal’s print line to n, which can be between 1 and 254. 
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5.2 Creating a Log File of a Terminal Session 


This section tells you how to create and use a terminal log file to save a copy of 
the output that appears during a session at your terminal. After you open the 
log file, all characters that are written to the terminal are saved in the file. Note 
that you can use a terminal log file either at the interactive level or within a 
command procedure. Whenever a log file is open and terminal logging is in effect, 
DCL changes its dollar sign prompt ($) to a dollar sign followed by a period ($.), 
as a reminder that logging is in effect. 


The characters written to a log file are the same characters output to the 
terminal, with the following exceptions: 


e Messages broadcast to the terminal do not appear in the log file. 


¢ If you enter Ctrl/T at the terminal, neither the “T nor the one line status 
display appear in the log file. 


e If you enter Ctrl/R at the terminal, neither the “R nor the redisplayed line 
appear in the log file. 


Note that any condition or command that disables terminal output, such as 
entering Ctrl/O at the terminal, also disables output to the log file. In addition, 
if you enable a log file during execution of a command procedure, the SET 
NOVERIFY command disables output of DCL command lines both to the 
terminal and to the log file. The SET NOECHO command disables output of data 
and command lines to the terminal only; output continues to be written to the log 


file. 

The following sections describe the commands that you use to: 
e Open a terminal log file 

e Close a terminal log file 


e Selectively disable and enable output to the log file 


5.2.1 OPEN/LOG_FILE 


The OPEN/LOG_FILE command opens a disk file for terminal logging. You can 
issue the OPEN/LOG_FILE command either interactively or within a command 
procedure. 


You can only open one log file at any given time. Ifa log file is already open when 
you attempt to open a second log file, RSTS/E issues an error message and does 
not open the second file; instead, the current log file remains open. 
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Format 


OPEN/LOG_FILE file-spec 


Command Qualifiers Defaults 
/APPEND See discussion 
/DISABLE /ENABLE 
/ENABLE /ENABLE 
/[NO]JREPLACE See discussion 
/[NO]TIME_STAMP /NOTIME_ STAMP 
Prompts 


File: file-spec 


Command Parameters 


file-spec 

Specifies the disk file to open for logging terminal output. RSTS/E displays an 
error message if you specify a nondisk file, or if the file-spec is invalid. RSTS/E 
also displays an error message if a log file is already open. If you do not specify a 
file type, RSTS/E assumes a file type of .LOG. Unless you include the /APPEND 
qualifier, RSTS/E opens the file for output, and deletes any existing file of the 
same name. | 


Command Qualifiers 


/APPEND 

Tells RSTS/E to add data to the end of the file you specify. This qualifier lets you 
append terminal output to the end of an existing log file. If the file you specify 
does not exist, RSTS/E ignores this qualifier and opens a new file. Note that only 
RSTS/E stream ASCII files can be appended: if you specify a file that has RMS 
attributes, an error message displays. 


/DISABLE 
Indicates that terminal output should not be logged to the file until you issue the 
SET LOG_FILE/ENABLE command to enable terminal logging. 


/ENABLE 
Indicates that output should be logged to the file. This qualifier is the default 
when you issue the OPEN/LOG_FILE command. 


/REPLACE 

/NOREPLACE 

Specifies whether to replace an existing file with a new file. If the log file that 

you specify already exists: 

e The /REPLACE qualifier tells RSTS/E to delete the existing file and create a 
new file. 


e The /NOREPLACE qualifier tells RSTS/E not to replace the file if it exists; in 
this case, an error message displays. 


If you specify neither qualifier, RSTS/E issues a warning message and asks if you 
want to replace the file. 
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Note that this qualifier conflicts with the /APPEND qualifier. 


/TIME_STAMP 

/NOTIME_STAMP 

Indicates whether to prefix each line in the log file with a date/time stamp. The 
default is /NOTIME_STAMP. However, if you specify /TIME_STAMP, RSTS/E 
prefixes each line in the log file with a date/time stamp specifying the date and 
time that the line was copied to the log file. Note that the date and time format 
is based on the system defaults that your system manager establishes. The 
date/time fields occupy the first 22 characters of each line. 


Here is an example using the OPEN/LOG_FILE command: 
$ OPEN/LOG FILE/TIME STAMP TERM.LOG <RET> 
$. 


This command opens the log file TERM.LOG. The TIME_STAMP qualifier 
specifies that the date and time is to precede each line written to the log file. 
Note that after you open the log file, the prompt indicates that a log file is active. 
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5.2.2 CLOSE/LOG FILE 


The CLOSE/LOG_FILE command closes a log file that you opened with the 
OPEN/LOG_FILE command. 


Format 
CLOSE/LOG FILE 


Use the CLOSE/LOG_FILE command to close an open log file either during a 
session at your terminal or within a command procedure. The RSTS/E monitor 
makes sure that any open log file is closed whenever you log out of the system or 
whenever your job is killed. 


If logging is enabled when you issue the CLOSE/LOG_FILE command, RSTS/E 
writes the command itself to the log file, before closing it. If no log file is open 
when you issue this command, RSTS/E displays an error message. For example: 


! Get a list of files in the directory 
$ OPEN/LOG FILE DIR.LOG 
$ .DDIRECTORY 


Name .Typ Size Prot Name .Typ Size Prot S¥s [52,20] 
FINISH.COB 120 < 60> LETTER .MEM 4 < 60> 

START .BAS 89 < 60> ROAD .MAP 3 < 60> 

TEMP 16. TMP 258 < 60> 


Total of 484 blocks in 5 files in SY¥:[52,20] 
$ .CLOSE/LOG FILE 


This example: 

1. Opens the log file DIR.LOG with the OPEN/LOG_FILE command. 

2. Lists the files in your directory, which are also written to the log file. 
3. Closes the log file with the CLOSE/LOG_FILE command. 


5-14 Terminal Status and Operations 


5.2.3 SETLOG FILE 


Format 


After you open a log file, you can use the SET LOG_FILE command to selectively 
enable and disable logging to the file. You can also use this command to enable or 
disable the time stamp feature in the log. 


SET LOG FILE 


Command Qualifiers Defaults 
/DISABLE none 
/ENABLE none 
/[NO]JTIME_STAMP none 


Command Qualifiers 


/DISABLE 

Indicates that terminal or command file output should not be logged to the 
current log file. If logging is currently disabled, RSTS/E ignores this qualifier. 
This qualifier conflicts with /ENABLE. 


/ENABLE 

Indicates that terminal or command file output to the log file should be enabled. 
If logging is currently enabled, RSTS/E ignores this qualifier. This qualifier 
conflicts with /DISABLE. 


/[NO]JTIME_STAMP 
Enables or disables the time stamp feature, which prefixes each line in the log 
file with a date/time stamp in a format that your system manager has defined. 


Use the SET LOG_FILE/DISABLE command to temporarily suppress output to 
the current log file. After you disable logging, RSTS/E displays the $ prompt to 
indicate that logging is disabled. 


If you issue the SET LOG_FILE/DISABLE command when no log file is open, 
RSTS/E displays an error message. If you issue the command when logging is 
already disabled, RSTS/E ignores the command. For example: 


$ OPEN/LOG FILE TEMP.LOG <RET> 


INQUIRE FILE "Enter the name of the file to edit" 
SET LOG FILE/DISABLE 


EDIT ‘'FILE’ 


nw UN WM 


SET LOG FILE/ENABLE 


tn 


CLOSE/LOG FILE 


EXIT 


Ops 
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In this command procedure you: 
1. Open the log file TEMP.LOG and write output to the file. 
2. Use the INQUIRE command to prompt for the name of a file to edit. 


3. Issue the SET LOG_FILE/DISABLE command to temporarily disable logging 
because you do not want to log the editing session. 


4. Use the SET LOG_FILE/ENABLE command to reenable logging after the 
editing session ends, and continue writing output to the file. 


5. Issue the CLOSE/LOG_FILE command to close TEMP.LOG before the 
procedure exits. 


Use the SET LOG_FILE/ENABLE command to reenable output to an open log 
file. After you reenable logging, RSTS/E displays the DCL $ prompt followed 
by a period ($.), to indicate that logging is in effect. If you issue the SET LOG_ 
FILE/ENABLE command when no log file is open, RSTS/E displays an error 
message. If you issue the command when logging is already enabled, RSTS/E 
ignores the command. 


Note that you can also use this command to enable or disable the time stamp 
feature, as well as enabling or disabling output to the current log file. For 
example: 


$. !Disable logging temporarily 
S$. SET LOG FILE/DISABLE 


$ !Now reenable logging 
S$ SET LOG FILE/ENABLE 


$. !Now disable time stamps 


$.SET LOG FILE/NOTIME STAMP 


S$. !Now reenable time stamps 


. SET LOG FILE/TIME STAMP 


MW 


In this example, you temporarily disable and reenable logging, and then tem- 
porarily disable and reenable time stamps in the log file. 
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Chapter 6 


Working with Devices 


All RSTS/E users share the system’s peripheral devices, such as line printers and 
magnetic tape drives. You can refer to these devices by either physical or logical 
device names. 


Table 6-1 summarizes the commands you use to work with devices. 


Table 6-1: Commands for Devices and Logical Names 


Command | Meaning 

ALLOCATE Reserves a device so that only you can use it 

DEALLOCATE Releases a device from your exclusive use, so that other 
users may access the device 

MOUNT Logically loads a magnetic tape or disk onto a device 

INITIALIZE Clears ("zeros") a tape for use 

DISMOUNT Logically unloads a magnetic tape or disk from a device 

SHOW DEVICE Displays devices that are in use on your system 

SHOW DEVICE/ALLOCATED Displays status of allocated and open devices 

SHOW DISKS Displays status of all mounted disks 

ASSIGN Assigns a logical name to a directory or a physical device 

DEASSIGN Cancels logical name assignments you made with the 


ASSIGN command 


6.1 Working with Physical Devices 


Each of the devices on a RSTS/E system has its own device name. A physical 
device name is also called a device designator or device specification (because you 
use it to specify a device). 


The system assigns physical device names to peripheral devices, such as: 

e Line printers (LP:) 

e Terminals (KB: or TT:, for "keyboard") 

e Magnetic tape drives (MM:, MT:, or MS:, depending on the kind of tape drive) 
e Disk drives (such as DB:, DM:, or DR:, depending on the kind of disk) 

Note that a physical device name consists of two letters, optionally followed by a 
unit number, and always ended with a colon (:). The alphabetic characters are 


generally an abbreviation of the device’s generic name. The unit number uniquely 
identifies the device itself or the drive on which it is mounted. 
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You can use physical device names in all operations that let you specify a 
device. For example, you can display the characteristics of a specific terminal by 
including a physical device name, such as KB2: 


S$ SHOW TERMINAL KB2: 


<RET> 


Similarly, you can determine which disk or magnetic tape you want to use in file 
transfer operations. For instance, assume you have a tape mounted on a tape 
drive named MT2:. To copy file RACE.ME in your directory to the tape on drive 


MT2:, type: 


S$. COPY RACE.ME MT2: 


<RET> 


Another example of a physical device name is SY:, which refers to the public 
disk structure. You can therefore use SY: to refer to the public disk structure, 
regardless of the drive on which a disk is located. Such an assignment is useful 
if, for example, the drive on which the disk is usually mounted is put offline 

for maintenance, and the system disk is temporarily mounted on another drive. 
Then, in order to reference accounts on the system disk, you do not need to adapt 
your commands or programs to fit hardware changes. 


If you do not specify a physical device name, the system assumes the public 
structure (SY:). For non-file-structured devices (for example, a line printer) 
you only need to specify the physical device name; the system ignores any 
specified file name, type, or directory. 


Physical device names are also often used in logical name assignments (discussed 
later in this chapter). The following example assigns the logical name MARCH to 
DB2:, which is a disk drive: 


S$ ASSIGN DB2: 


MARCH <RET> 


Table 6—2 lists the RSTS/E physical device names. 


Table 6-2: RSTS/E Physical Device Names 


Designator 


DK:, DL:, DM:, DP:, DR:, 
DB:, DU:, or SY: 


SY0: 

DKO: to DK7: 
DLO: to DL3: 

DMO: to DM7: 
DPO: to DP7: 

DRO: to DR7: 

DBO: to DB7: 


DUO: to DU15: 


CR: 
CD: 
MT0: to MT7: 


MMo: to MM7: 


MSO: to MS3: 


6-2 Working with Devices 


Device 


RSTS/E public disk structure 


System disk 

RKO5 disk units 0 through 7 

RLOI/RLO2 disk units 0 through 3 

RK06/RKO7 disk units 0 through 7 

RP02/RP03 disk units 0 through 7 
RM02/RM03/RM05/RM80 disk units 0 through 7 
RP04/RP05/RP06 disk units 0 through 7 


RA90/RA82/RA81/RA80/RA70/RA60/RC25/RD54/RD53/RD52/ 
RD51/RX50/RX33 units 0 through 15 


CR11 punched or CM11 mark sense card reader 

CD11 punched card reader 

TE10/TU10/TS03 magnetic tape units 0 through 7 
TE16/TU16/TU45/TU77 magnetic tape units 0 through 7 
TS11/TU80/TSV05 magnetic tape units 0 through 3 


(continued on next page) 


Table 6-2 (Cont.): RSTS/E Physical Device Names 


Designator Device 

MUO: to MU1: TK50/TU81/TUS8I1E: magnetic tape units 0 or 1 

LPO: to LP7: Line printer units 0 through 7 

DT0O: to DT7: TU56 DECtape units 0 through 7 

KB: Your terminal 

KBn: Terminal n on the system 

KBAnn: Terminal on subline nn of a DL11 A,B type single line 
interface 

KBBnn: Terminal on subline nn of a DL11 C,D type single line 
interface 

KBCnn: Terminal on subline nn of a DLI1E type single line modem 
interface 

KBDnn: Terminal on subline nn of a pseudo keyboard 

KBFnn: Terminal on subline nn of a DH multiplexer 

KGBnn: Terminal on subline nn of a DZ/DZV/DZQ multiplexer 

KBHnn: Terminal on subline nn of a DVH/DHU multiplexer 

KBInn: Terminal is a LAT terminal 

TT: or TI: Your terminal (synonyms for KB:, the terminal that initiated 
the job) 

TTn: Terminal n on the system (synonym for KBn:) 

NL: The null device 

PKn: Pseudo keyboard n 

DX0O: to DX7: or RX01/RX02 flexible diskette (floppy disk) units 0 through 7 

DYO: to DY7: 


NOTE 


You can reference LPn:, DTn:, DXn:, KBn:, MMn:, MTn:, and MSn: 
where n is between 0 and the maximum number of such units on 
the system. LP:, DT:, DX:, MM:, MT:, and MS: are each the same as 
specifying unit 0 of the related device. 


If your system has only TS11, TU80, or TSV05 tape units, the 
designators MS: and MT: are the same. If your system has only TE16, 
TU16, TU45, or TU77 tape units, the designators MM: and MT: are the 
same. 


If you do not specify a unit number, the defaults are: 


Disk — Public structure 
Keyboard - Yours 
All other device - Unit 0 


Use the SHOW DEVICE command, described later in this chapter, for a list of 
devices in use on your system. If you specify a device or type of device that is 
not part of your system’s configuration, the system displays the following error 
message: 


?Not a valid device 


An underscore (_) before a name suppresses any interpretation of the name as a 
logical name. For example, if you assign the logical name MTO: to a disk, you 
specify MT0O: when you want to refer to magnetic tape unit 0. 
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6.1.1 Allocating Devices 


Sometimes you may need to allocate (reserve), a device for your exclusive use. 
Only one job at a time can use an allocated device. 


You can only allocate devices that are not already in use. For example, if another 
user is already using a tape drive, you cannot immediately allocate it to yourself. 
If you attempt to do so, the system displays the following error message: 


?Device not available 


6.1.2 Assigning and Allocating Devices 


The ALLOCATE command allocates a device to you. ALLOCATE can also assign 
a logical name for the device you are using. 


Use the ALLOCATE command to assign logical names and allocate devices for 
your use. Use the ASSIGN command to assign logical names only. In either case, 
you get an error message if you try to exceed the number of logical names you 
can assign. 


The DEALLOCATE command releases a device from your exclusive use, but only 
the DEASSIGN command cancels the logical name assignment. 


6.1.3 Device Independence 


Device independence is a central idea in RSTS/E. This means that you can use 
a file on one device much as you can use a file on any other device. This idea 
applies both to the system user and to the programmer. 


As much as possible, the system tries to hide the differences between devices 
from both the system user and the programmer. For example, you can read data 
that is on a tape just as you read data that is on a disk. 


However, different devices offer different capabilities. RSTS/E cannot entirely 
hide these differences. The following sections discuss some of the differences 
among devices. 


6.2 Working with Disks 


A disk is either public or private, as determined by your system manager. Any 
user who has an account on the system can create files on a public disk. If a disk 
is private, you cannot place files there unless your system manager (or a user 
with sufficient privileges) creates an account for you on that disk. 


Every RSTS/E installation has at least one public disk (and sometimes more), 
called the system disk. For most purposes, the public disks on a given system are 
treated as a unit. This unit is called the public disk structure, and has the device 
name SY: (which stands for system). 


When you create a file and do not specify what device to create it on, or when you 
specify SY:, the system creates the file on one of the public disks. (The system 
also decides which public disk to create it on if there is more than one public 
disk.) When you specify an existing file and do not specify a device (or when you 
specify SY:), the system searches each of the public disks for the file. 
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You cannot have two files of the same name and type on two different public 
disks, just as you cannot have two files of the same name and type on a single 
disk. If you try to give a file the same specification as an existing file, one of the 
following two things can happen (depending on the command): 


e You get the following error message: 
?Name or account now exists 


° The existing file is replaced 


6.2.1 The Public Disk Structure 


Users share computing time on the RSTS/E system. Each user is allocated a 
"slice" of the processor’s time. Users may share another system resource as 

well: the array of devices. One set of devices (disks) is shared by a number of 
users. This shared set of devices is called the public disk structure, because it is 
always accessible to all users and because the system treats it as a unit. On some 
systems, it may include many separate disk packs. One of these, the system disk, 
contains the system code, language processors, and, possibly, the library of system 
programs. The other disk packs (the public disks) contain information created by 
the users. (The system disk also may contain user programs and data, which are 
stored in files.) 


When you are logged in to the system and working with a disk file, you are 
usually not concerned about which disk in the public structure happens to 
contain your file. The particular disk is chosen by the system according to 
current time-sharing needs. Each of the disks contains a master list of users’ 
accounts, and, for each account, a list of all files stored under that account. By 
using these lists, the system is able to locate your file when you request it from 
your terminal. 


6.2.2 Private Disks 


A good deal of system file activity, such as creation, access, editing, and deletion, 
takes place on the public disk structure. Because it is the largest constantly 
available medium of file storage, it is generally the busiest. However, not all the 
disks on the system need be in the public structure. Some of them may be private 
disks, which belong to a single user account or perhaps to a few user accounts. 
(These accounts alone are on the disk.) 


An important difference between a private disk and one on the public structure 
is that you can always create a file on the public structure, whereas you can 

do so on a private disk only if you have a directory there. On both types of 
disks, file protection codes govern your read and write access to existing files. 
Another difference is that a private disk can be mounted or dismounted at any 
time, whereas a public disk must remain mounted during timesharing. This 
difference is of special concern to the owner(s) of the private disk and to your 
system manager, who determines which disks on the system are public and which 
are private. 


Working with Devices 6-5 


6.3 Working with Magnetic Tapes 


Magnetic tape is a compact, relatively inexpensive medium that can provide large 
amounts of offline storage. One reel of magnetic tape can store many files. 


Unlike disks, magnetic tape allows only sequential access to files. 

To copy files from a tape, you should: 

1. Allocate the drive. (This step is optional, but it provides security.) 
2. Physically mount the tape. 


3. Issue the MOUNT command. (This step is optional, if the tape has default 
density and format.) The MOUNT command also allocates the drive, if you 
did not allocate it already. 


4. Copy files from the tape using the COPY command. (With the COPY 
command, you can copy a file that requires multiple tapes. User programs 
can access tape files if they are stored on only one tape, but system programs 
can access files stored on more than one tape.) 


5. Issue the DISMOUNT command. (This step is optional, but it deallocates the 
drive and rewinds the tape.) 


6. Physically dismount the tape. 


6.3.1 Protecting Files on Tapes 


Protection of files on tapes works differently from protection of files on disks. 
While you are using a tape, the device is allocated to your job. While the device 
is allocated to you, you have complete control over the tape. You can read any 
file on it. No other user can access the tape while it is allocated to your job. The 
MOUNT command and the ALLOCATE command both allocate the tape device 
to your job. The DISMOUNT, DEALLOCATE, and LOGOUT commands free the 
tape device so that other jobs can allocate it. 


6.3.2 Tape Density 


When you initialize a tape on a device, you decide what the tape’s density will be. 
The two considerations are: 


¢ The amount of information to be stored on the tape 


e The degree of portability (interchangeability) between systems 


For example, assume you have a choice of specifying a density of 800 or 1600 bits 
per inch (bpi). You can get roughly twice as much information on a tape with a 
density of 1600 bpi; however, not all tape drives support 1600 bpi. 


6.3.3 ANSI and DOS Format 


RSTS/E has two file structures for tapes: 


e ANSI format, because it complies with the standards of the American 
National Standards Institute 


e DOS format, because RSTS/E adopted it from the Disk Operating System 
format. 
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The ANSI format is an industry standard. The advantages to using ANSI format 
tapes are: 


° Portability — If you expect to move the contents of a tape from one system to 
another, it is very possible that the other systems will recognize ANSI format. 


¢ Multiple tapes — The files you copy can be stored on more than one reel of 
tape. 
NOTE 


Where ANSI is used in RSTS/E documentation, it refers to the RSTS/E 
implementation of American National Standard X3.27-1978, magnetic 
tape labels and file structure for information exchange. RSTS/E 
implements a subset of this standard. 


In addition, RSTS/E uses U (undefined) record format, which is not 
defined in ANSI standard X3.27-1978. 

The advantages of using DOS tape are: 

e Files are associated with PPNs. 

e Files are better for storing binary files that have no attributes, such as .OBJ 


(object) or .BAC (compiled BASIC-PLUS) files. 


When you initialize a tape with the INITIALIZE command, you can select either 
ANSI or DOS format. Later, when you mount the tape, you must again tell 

the system whether the tape is in ANSI or DOS format. If you do not specify a 
format, the system uses the default determined by your system manager. 


There are three ways to tell if a tape containing data is written in DOS or ANSI 
format: 


e Look for a label on the tape. The person who put data on the tape may have 
placed a label on the tape and written DOS or ANSI on it. 


e Try mounting the tape as either DOS or ANSI. When you mount a tape on 
a drive, RSTS/E checks the format. If you entered the right format, you can 
continue with tape operations. If you entered the incorrect format, RSTS/E 
displays the following error message: 


?Bad directory for device 
You can try again using the other format. 


e Use the MOUNT command, and don’t specify a format. 


If the tape is in ANSI format, then files on the tape do not have PPNs. They have 
only names and types. 


If the tape is in DOS format, then each file on the tape has a PPN. The PPN of a 
tape is like the directory on a disk file. For example, a DOS format tape on drive 
MT0: might contain a file whose specification is: 


MTO:[1,2]SLOW.RUN 
Another file on the tape might have the specification: 


MTO: [3,49]GOOD.RUN 
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6.4 Physical Device Commands 


This section contains descriptions of some commands you use when working with 
physical devices. See the RSTS/E System Manager’s Guide for commands and 
functions that require additional privileges to use. 


6.4.1 ALLOCATE 


The ALLOCATE command reserves a physical device for your use during the 
current session and optionally establishes a logical name for the device. Once 
a device has been allocated, other users cannot access the device until you 
specifically deallocate it or logout. You can allocate a device only when it is not 
allocated by another job. 


Format 
ALLOCATE device-namef[:] [logical-namef:]] 
Command Qualifiers Defaults 
/[NO]QUEUED See discussion 
Prompts 


Device: device-name 


Command Parameters 


device-name[:] 
A logical or physical name. 


logical-name[:] 

Specifies a one- to fifteen-character logical name to be associated with the device. 
RSTS/E automatically translates any references you make to the logical name 
to a physical device associated with the name. The logical name parameter is 
optional. 


Command Qualifiers 


/QUEUED 

/[NOJQUEUED 

The ALLOCATE NO]QUEUED command temporarily sets the queueing char- 
acteristic of the local LAT port you are allocating. This setting remains in effect 
until you deallocate the device. This qualifier is only valid if the device being 
allocated is a local LAT port. 


If /QUEUED is specified, connections initiated by this local LAT port to a terminal 
server are placed on the server’s queue if the server supports queueing and the 
remote port is currently busy. If /NOQUEUED is specified, connections are not 
queued and fail if the remote port is busy. 
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Use the SHOW PORT command to display the port’s connection status. If the 
port is set /(QUEUED, and the server is busy, a connection status of "In Progress" 
and the position in the queue are shown. 


If this qualifier is not specified, the queued setting that was specified when the 
port was created or assigned is used during the time that you have it allocated. 
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6.4.2 DEALLOCATE 


Format 


The DEALLOCATE command releases a device that you reserved for private use, 
so that other users may have access to it. (However, note that DEALLOCATE 
does not deassign any logical name you may have assigned to the device; for that 
you need the DEASSIGN command. ) 


DEALLOCATE [device-name]:]] 


Command Qualifiers Defaults 
/ALL none 
Prompts 


Device: device-name[:] 


Command Parameters 


device-name{[:] 

Specifies the name of the device to be deallocated. The device name can be a 
physical device name or a logical name. The device name parameter is required 
unless you specify the /ALL qualifier. 


Command Qualifiers 


/ALL 
Requests that all devices you have currently allocated be deallocated. 


If you specify /ALL, you cannot specify a device name. 
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6.4.3 MOUNT 


Format 


The MOUNT command prepares a tape or disk for processing by system com- 
mands or user programs. Issue the MOUNT command after you physically mount 
the tape or disk and put the drive on line. 


NOTE 


The MOUNT command has additional capabilities for users with 
greater levels of privilege. See the RSTS/E System Manager’s Guide 
for more information. 


If the MOUNT command fails with the following error message, but 
you do not have sufficient privileges, have your system manager mount 
the disk: 


?Disk pack needs REBUILDing 


For disks: 
MOUNT device-namef:] pack-id [logical-name]] 
For magnetic tapes: 


MOUNT device-namef:] {[label]} 


Command Qualifiers Defaults 
/[NO]WRITE See discussion 
Command Qualifiers for Disks Defaults 
/PRIVATE /PRIVATE 
/[NOJSHAREABLE /SHAREABLE 
Command Qualifiers for Tapes Defaults 
/DENSITY=n See discussion 
/FORMAT=ANSI none 
/FORMAT=DOS none 
/FORMAT=FOREIGN none 

Prompts 


Device: device-name[:] 
Label: label (for ANSI tapes only) 
Pack-id: pack-id (for disks only) 


Depending on whether you are mounting a tape or disk, the MOUNT command: 
e Specifies a tape’s density and format 

e Checks that a tape or disk’s device specification is correct 

e Checks that a tape or disk has been initialized 


e Verifies that a tape or disk drive has not been allocated to another user 
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e Allocates a tape drive (reserves it for your use) 
¢ Verifies that a disk or tape is physically loaded on the device you specified 


e §6Verifies that the pack-id on a disk or the label on a tape (except for DOS tape) 
matches the label you specified 


e Allows you to mount a private pack for your own use 


Command Parameters 


device-name[:] 
Specifies the physical or logical name of the drive on which a device is to be 
logically mounted. 


pack-id 

logical-name 

label 

Identifies the tape or disk to be mounted. The pack-id or label can have from one 
to six alphanumeric characters. The logical-name can be up to 15 characters. 


The label is required when you mount a disk or a tape in ANSI format. It is not 
required (and is ignored) when you mount a tape in DOS or foreign format. 


Command Qualifiers 


/WRITE 

/NOWRITE 

Controls whether or not you can write data to a tape or disk. The /WRITE 
qualifier allows you to modify the data contained on a tape or disk. If you specify 
/NOWRITE, you cannot modify the data. 


You can specify /NOWRITE to provide read-only access to protect files. For a 
disk, this is equivalent to write-protecting it. For a tape, the drive itself must be 
write-protected; /NOWRITE simply generates an error message if the device is 
not write-protected. 


When the device is not write-protected, /WRITE is the default for tapes. When 
the disk drive is not write-protected, /WRITE is also the default for disks 
(initialized as read/write). However, /NOWRITE is the default if the drive is 
write-protected. Therefore, if you receive the warning message %Device write 
protected, you have logically mounted your disk or tape with read-only access. 
The default is also /NOWRITE for disks initialized as read-only. 


/PRIVATE 

Allows you to mount a private disk, accessible only to those users who have 
accounts on the disk. (Your system manager designates whether disks are public 
or private.) 


/SHAREABLE 

/NOSHAREABLE 

Determines whether the private disk you use is shared. The /NOSHAREABLE 
qualifier allows you to mount a private disk that is accessible only to the job that 
mounts it. The /SHAREABLE qualifier allows all users who have accounts on 
the disk to access it. The /PRIVATE and /SHAREABLE qualifiers have the same 
meaning. If you specify /NOSHAREABLE, you cannot specify /PRIVATE. 


The default is /SSHAREABLE. 
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/DENSITY=n 

Specifies the density in bits per inch (bpi) at which the tape will be read or 
written. This qualifier is valid only with tapes. You can specify 800, 1600, 6250, 
6667, 8000, or 10000 bpi, depending on the density supported by the tape drive. 
The default density depends on your installation. 


/FORMAT=ANSI 

/FORMAT=DOS 

/FORMAT=FOREIGN 

Indicates whether the tape is in a standard format used by the RSTS/E operating 
system. This qualifier is valid only with tapes. A tape is FOREIGN if it is not 
in ANSI or DOS format. If you mount a tape with /FORMAT=FOREIGN, the 
program you use to read the tape must be able to process any labels on the tape. 
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6.4.4 INITIALIZE 


The INITIALIZE command deletes any data on a tape and writes a new label. 
INITIALIZE allocates the tape drive if it is not already allocated. 


Use INITIALIZE to prepare a new tape or a tape that contains no useful files. 
Use MOUNT to prepare an already initialized tape that contains files you want 
to keep. 


NOTE 


See the RSTS/E System Manager’s Guide for information on using 
INITIALIZE with disks. 


Format 
INITIALIZE device-namef[:] [label] 
Command Qualifiers Defaults 
/DENSITY=n See discussion 
/FORMAT=ANSI See discussion 
/FORMAT=DOS See discussion 
Prompts 
Device: device-name[:] 
Label: label 


Proceed (Y or N): 


NOTE 


The label prompt appears only for a tape in ANSI format or if 
/FORMAT=ANSI is specified. The proceed prompt asks you to confirm 
whether you want to initialize the tape. Type yes or no (Y or N) in 
response to the prompt. 


Command Parameters 


device-name[:] 
Specifies the name of the drive on which the tape is physically mounted. 


label 

Specifies the identification to be encoded on the tape. You can specify a maximum 
of six alphanumeric characters. For an ANSI-format tape, the label is required. 
For a DOS-format tape, the label is ignored, because DOS tapes do not have 
labels. 
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Command Qualifiers 


/DENSITY=n 
Specifies the density in bpi at which to write the tape. You can specify a density 
of either 800, 1600, 6250, 6667, 8000, or 10000 bpi if the tape drive supports it. 


If you do not specify a density, the system uses the default specified by your 
system manager. 


/FORMAT=ANSI 

/FORMAT=DOS 

Specifies the tape format. If you do not specify a format, DCL uses the default 
determined by your system manager. 
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6.4.5 DISMOUNT 


The DISMOUNT command releases a disk or tape previously accessed with a 
MOUNT command. Use the DISMOUNT command before you take the drive off 
line, or before you physically dismount the tape or disk. 


NOTE 


The DISMOUNT command has additional capabilities for users with 
greater levels of privilege. See the RSTS/E System Manager’s Guide 
for more information. 


The DISMOUNT command deallocates the device if it was allocated to you. You 
cannot DISMOUNT a device if there are open files on it. If you try, RSTS/E 
displays the error message: 


?Account or device in use 


Format 
DISMOUNT device-namef:] [label] 
Command Qualifiers for Tapes Defaults 
/[NOJUNLOAD /UNLOAD 
Prompts 


Device: device-name[:] 
Pack-id: pack-id label 


Command Parameters 

device-name[:] 

Specifies the name of the device to be dismounted. If you omit a unit number, the 
default depends on the type of device. 


label 

Specifies the identification label of the device. Unless you have additional 
privilege, you must specify a disk’s pack-id label to dismount it. For tapes, the 
label is optional (and is ignored). 


Command Qualifiers 


/UNLOAD 

/[NOJUNLOAD 

Rewinds and unloads the tape. This protects the tape against unauthorized 
access by other users. The default is /UNLOAD. 
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6.4.6 SHOW DEVICE, SHOW DEVICE/ALLOCATED, SHOW DISKS 
There are three SHOW commands that display information about physical devices 
on the system. They are: 


e SHOW DEVICE [dev:] — Displays all devices on the system, or a specified 
device 


e SHOW DEVICE/ALLOCATED — Displays the status of all allocated and 
open devices 


e SHOW DISKS — Displays the status of all mounted disks 


Examples of each command, and their displays, follow: 


S SHOW DEVICE KB32: <RET> 
Device _KB32: (KBG3 : ) Control DZ0:3 CSR 760140 Status: Restricted 


$ SHOW DEVICE/ALLOCATED <RET> 


Busy Devices: 


Device Job Why 
PKO 10 Open 
DMR-O TRN AS+Open 
DMC=-1 TRN AS+Open 
DMP-O .0 TRN AS+Open 


$ SHOW DISKS <RET> 


Disk Structure: 


Dsk Open Size Free Clu Err Name Level Comments 
DB3 O 340664 15288 4% 8 0 DBL8 Les Pri, R=-0, DLW, DP 
DB4 2 340664 21920 6% 8 2s ae Pri, DLW 
DUI 47 400168 41864 10% 8 O GROKSY 1.2 Pub, DLW 


See the RSTS/E System Manager’s Guide for more information on each column 
type in the previous three examples. 


Table 6-3 contains the abbreviations included in the SHOW DEVICE/ALLOCATED 
and SHOW DISKS displays. 


Table 6-3: Abbreviations in SHOW DEVICE/ALLOCATED and SHOW DISKS 
Displays 


Abbreviation Meaning Description 


SHOW DEVICE/ALLOCATED Command 


AS Assigned Device is explicitly allocated to a job. 

OPEN Open Device is open on a channel. 

DOS DOS Magnetic tape is assigned with DOS (Disk 
Operating System) format. 

ANSI ANSI Magnetic tape is assigned with ANSI 
(American National Standards Institute) 
format. 

TRN Network Services The monitor is using the device for DECnet 
communications. 


(continued on next page) 
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Table 6-3 (Cont.): Abbreviations in SHOW DEVICE/ALLOCATED and SHOW 
DISKS Displays 


Abbreviation Meaning Description 
SHOW DISKS Command 
Pub Public Disk is public. 
Pri Private Disk is private. 
NFS Non-file- structured Disk is open as a non-file-structured device. 
R-O Read-only Disk unit is read-only (write-protected). 
DLW Date of Last Write Date of last write (modify), rather than 
date of last access, is stored in file account- 
ing entries. 
DP Dual-Ported The disk can be accessed by two different 


RSTS/E systems at the same time. The 
disk must be read-only. 


Leck Locked Disk is in a locked state. 

NFF New Files First New files on the disk are put at the begin- 
ning of the directory. 

Job n Job n Private disk is allocated to job n (reported 
with PRI and NFS). 

Dirty Dirty Disk needs rebuilding (reported with PRI, 
LCK, and R-O). 


6.5 Logical Names 


Logical names let you keep programs and command files independent of the 
physical locations of those files. They also provide a convenient shorthand way to 
specify devices and directories that you refer to frequently. 


You can assign a logical name to a physical device name or to a directory. The 
logical names that you assign are valid for your job only. For example, only your 
job can reference the logical name that you assign to a device. No other job can 
reference that logical name. 


6.5.1 Logical Names and Devices 


You can use logical device names to describe the nature of information on a disk, 
magnetic tape, or other medium. The logical name may be easier to remember 
than the physical name with its device number. You can choose a logical name 
without regard to what device types may be available at some future time. 


The logical names that you assign for devices do not depend on the physical 
device specifications. Unlike a physical name, a logical name is independent of 
the drive on which the medium is mounted. Logical device names make it easier 
to adapt a program for use on different drives. Thus, if you write a program 
referencing physical devices, you can give these devices logical names of your own 
choosing by issuing the ASSIGN command. This action associates your chosen 
names with the devices and makes the program independent of the devices’ 
physical locations on the system. 
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6.5.2 Systemwide and User Logicals 


When you assign logical names, you are the only one who can use them. Your 
logical name assignments are deleted when you logout. The logical names that 
you assign are called user logical names, to distinguish them from systemwide 
logicals. 


Systemwide logicals are logical names that everyone on the system can use. 
Certain systemwide logicals are standard for most RSTS/E systems; others are 
assigned for your site by the system manager. See the RSTS/E System Manager’s 
Guide for more information on systemwide logicals. 


6.5.3 Numbers of Logical Names 


The maximum number of logical name assignments that a job can have is not a 
fixed limit. RSTS/E supports 100 - 170 logicals per job with logical names of up to 
15 characters each. A job can have approximately 100 long logicals (greater than 
six characters) or 170 short logicals (six characters or less) or a mixture of both. 


You can assign more than one logical name to a device. For example, you could 
assign to the tape on drive MMO: the logical names RACE1, RACE2, and RACES, 
and use any of these three names as your application requires. 


6.5.4 How to Override Name Precedence 


Sometimes you may have a logical name that conflicts with a physical name. 


The system always recognizes and accepts a device’s physical name, whether 
or not a logical name has been assigned to that device. Thus, you can specify 
a magnetic tape running on drive MT2 and assigned the logical name STAR as 
either MT2: or as STAR:. 


If you put an underscore before a physical name, the system will not try to 
interpret it as a logical name (for example, _MT2:). A physical device name 
preceded by an underscore causes the system to access that device, regardless of 
any prior assignment. 


RSTS/E evaluates the parts of a file specification in the following sequence. When 
a file specification contains a name followed by a colon, RSTS/E first determines 
whether or not the name is a user logical. If it is, then the system replaces the 
name with its expansion. (An expansion is the device name or PPN to which 

the logical name was assigned.) Otherwise, it checks to see if the name is a 
systemwide logical. 


If the name is not a systemwide logical, RSTS/E then determines whether the 
name designates a valid physical device on your RSTS/E system. (During system 
generation, your system manager selects which devices are valid on your system.) 


Finally, if the device name is not a physical device name, the system displays the 
error message: ; 


PNot a valid device 
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6.5.5 ASSIGN 


The ASSIGN command assigns a logical name to a directory or a physical device. 
The names you assign stay in effect until you logout, or until you deassign the 
name with the DEASSIGN command. 


NOTE 


The ASSIGN command has additional capabilities for users with 
greater levels of privilege. See the RSTS/E System Manager’s Guide 
for more information. 


Format 
ASSIGN  device-name:|[ppn]] logical-name[:] 
Command Qualifiers Defaults 
/USER /USER 
/[NOJREPLACE[=QUERY] /REPLACE 
Prompts 


Device: devnam:|[ppn]] 
Logical name: logical-name 


When you use the ASSIGN command, one of the following can occur: 
e The command works as expected, and no message is displayed. 


e The assignment statement is incorrect, and one of the following error 
messages displays: 


?Not a valid device 
2No file name or type permitted 


e You exceed the maximum number of logical name assignments you can make, 
and the following error message displays: 


?Too many logical names assigned 


e You reassigned a logical name and the following informational message 
displays: 


Previous logical name assignment replaced 


Command Parameters 


devnam:[[ppn]] 
Specifies the name of the device or PPN to be assigned a logical name. Brackets 
around the PPN are required, as in the following example: 


a a as a a bo to te ao oye & % rar FY ® oS ey atc ota 
RSSTAN MIPT « 7S PTA KPNDRA HTRPCTORY - 
Saeses LEY id be | Ge Ge | DLL L/S ENR L/S LE EN IRN GD 


P,P EP PX be 
~ Ex he Eh | Be aden Bs Bak be EE 


logical-name[:] 
Specifies a one- to fifteen-character logical name to associate with the device. 
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The ASSIGN command equates a logical name to a part of a physical file 
specification. The following example equates the logical name EXCER_DISK: to 
the directory DB2:[3,24]: 


$ ASSIGN DB2: [3,24] EXCER_DISK: 


The string "DB2:[3,24]" is called the "expansion" of the logical name 
EXCER_DISK. 


Later, you can refer to the directory by its logical name when you issue a RSTS/E 
command. For example: 


$ DIRECTORY EXCER DISK: 


When the system executes this DIRECTORY command, it replaces the logical 
name EXCER_DISK: with its expansion, DB2:[8,24], and lists all of the files in 
that directory on your terminal. 

Another example is: 

$ TYPE EXCER:RUNNER.DAT 

When the system executes this command, it replaces the logical name > 


EXCER_DISK: with its expansion and displays the contents of the file 
DB2:[3,24]RUNNER.DAT on your terminal. 


You can equate a logical name to a physical device name, to a directory, or to 
both. For example: 


S ASSIGN DB2: EXCER_DISK !(DB2: is a physical device) 
$ ASSIGN [3,24] EXCER_DISK: '([3,24] is a directory) 
S ASSIGN DB2: [3,24] EXCER_DISK: !([3,24] is a directory on DB2:) 


When you assign a logical name, the partial file specification that you assign to 
the logical name may itself include a previously assigned logical name. When the 
system executes the ASSIGN command, it replaces the previously assigned logical 
name with its expansion and displays an informational message. Therefore, if 
you later change the assignment of the first logical name, the expansion of the 
second logical name is not affected. For example, consider the following sequence 
of commands: 


$ ASSIGN DB2: WORK: 

$ ASSIGN WORK:[3,24] EXCER DISK: 
$ DEASSIGN WORK: — 

$ TYPE EXCER DISK:RUNNER.DAT 


In this example, the logical name EXCER_DISK: corresponds to DB2:[3,24]. The 
TYPE command displays DB2:[3,24]RUNNER.DAT even though the logical name 
WORK: has been deassigned. 


Command Qualifiers 


/USER 

The /USER qualifier indicates a user logical assignment. This qualifier is 
provided primarily for completeness; if you do not specify /USER or /SYSTEM, 
then the command assigns a user logical, as it did previously. You can include the 
/USER qualifier in DCL command procedures to explicitly state the type of logical 
assignment you are making. 
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/REPLACE[=QUERY] 

/[NO]JREPLACE[=QUERY] 

The /LNOJREPLACE[=QUERY] qualifier specifies what action to take if the logical 
name specified is already assigned. /REPLACE replaces the existing assignment 
with the new assignment. /NOREPLACE returns an error message if the logical 
name is already assigned. /REPLACE=QUERY prompts you to proceed with the 
assignment if the logical name is already in use. The default is /REPLACE. 
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6.5.6 DEASSIGN 


The DEASSIGN command cancels logical name assignments you made with the 
ASSIGN command. 


NOTE 


The DEASSIGN command has additional capabilities for users with 
greater levels of privilege. See the RSTS/E System Manager’s Guide 
for more information. 


Format 
DEASSIGN _[logical-namef:] 
Command Qualifiers Defaults 
/ALL none 
/USER See discussion 
Prompts 


Logical Name: logical-name[:] 


Command Parameters 


logical-name[:] 
Specifies a one- to fifteen-character logical name to deassign. 


A logical name is required unless you specify /ALL. If you do not specify either 
/ALL or a logical name, the system prompts you for a logical name. For example: 


$ DEASSIGN <RET> 
Logical Name: EXCER DISK <RET> 


Command Qualifiers 


/ALL 
Deletes all logical names that you assigned. For example: 


$ DEASSIGN/ALL <RET> 


/USER 

The /USER qualifier is provided primarily for completeness; if you do not specify 
/USER or /SYSTEM, then the command deassigns a user logical, as it did 
previously. You can include the /USER qualifier in DCL command procedures to 
explicitly state the type of logical deassignment you are making. 
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Chapter 7 


Print/Batch Services 


Whenever you use the PRINT command to print files or use the SUBMIT 
command to execute command procedures for batch processing, you are 
automatically using the RSTS/E Print/Batch Services (PBS) facility. This chapter 
describes the commands you use to: 


e Place entries on a print or batch queue for printing or batch processing 
e Check the status of your print or batch job on a queue 
¢ Modify your print or batch entry before it is printed or processed 


e Delete a print or batch entry from a queue 


Your system manager usually sets up default print and batch queues for your 
system, so that you only need to use the simple commands this chapter describes 
to print files or submit command procedures for batch processing. If you are 
interested in, or need to know, more detailed information about how PBS 
performs its print and batch processing functions, see the complete description of 
PBS organization and operations in the RSTS/E System Manager’s Guide. 


Table 7-1 summarizes the PBS commands that this chapter describes. 


Table 7-1: Print/Batch Services Commands 


Command Meaning 

PRINT Produces a listing, or "hard copy," of a file. 

SUBMIT Submits a command file for batch processing. 

SHOW ENTRY Displays the names of files that are currently being printed or 
processed, as well as files pending on the print or batch queue. 

SET ENTRY Modifies one or more attributes of a file that is entered on a print 
or batch queue. 

DELETE/ENTRY Cancels an entry on the print or batch queue. 

SHOW QUEUE Displays the status of a print or batch queue. 


7.1. Specifying Print and Batch Entries 
The PRINT and SUBMIT commands instruct PBS to enter files on a print or 


batch queue, respectively. A PBS queue controls how print and batch system 
resources are allocated. 
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Once a file is queued for printing or batch processing, it becomes an "entry." You 
may need to access your print or batch entry often. For example, you may want 
to modify the entry or delete it, or you may want to display the entry’s status 
in the queue so you can see whether it has started or finished printing or batch 
processing. PBS provides two methods of identifying and accessing entries in a 
queue: 


¢ Entry number 


° Entry specification 


7.1.1. Entry Number 


PBS assigns a unique entry-number to each queued print or batch entry. This 
number shows the order in which the entry was placed in the print or batch 
queue. Since it is unique, you can use the entry-number to identify and access 
your entry if you want to modify, delete, or display it. 


For example, here is an entry on a print queue, as displayed by the SHOW 


ENTRY command: 
Entry Pos Type Queue Owner Name Status Pri 
3686 lst Batch BASELEVEL [ 1,170] BLDMGR STARTED 200 


This display tells you that the entry-number is 3686, which you can then use to 
identify the entry while it is in the queue. 


7.1.2 Entry Specification 
Besides the entry-number, you can also access an entry in a queue by specifying 
the following attributes: 
¢ The name of the queue on which the entry is located 
e The entry’s owner (PPN) 
° The entry name 
PBS permanently establishes these attributes when it creates the entry; you 


cannot modify them once the entry is placed in the queue. The format of an 
entry-spec is: 


queue-name:[PPN]lentry-name 


Thus, you would type the entry-spec for the entry shown in the previous example 
as follows: 


PRINT: [1, 214]MAIL 


Unlike entry-numbers, entry-specs do not uniquely identify an entry. For 
instance, in the above example, you (as user [1,214]) could have several entries 
named MAIL on the print queue named PRINT:. You should therefore be very 
careful when using entry-specs to access an entry to modify or delete it; you 
might inadvertently modify or delete other entries having the same entry-spec. 
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7.2 Printing Files: 


The PRINT command queues one or more files for printing, either on the default 
print queue or on a queue you specify. 


Format 
PRINT 


RINT 


Command Qualifiers 
/AFTER=date-time 
/FORMS=form-name 


/HOLD 


/JOB_COUNT=n 
/NAME-entry-name 


[NODE::]file-specyf,...] [entry-spec] 


Defaults 

none 

See discussion 
none 

/JOB COUNT=1 
See discussion 


/[NO]NOTIFY /NONOTIFY 

/OWNERE(p,pn] See discussion 
/PAGE_LIMIT=n See discussion 
/PAGE_LIMIT=UNLIMITED See discussion 
/PRIORITY=n See discussion 
/QUEUE=queue-name['] See discussion 


File Qualifiers Defaults 
/[NO]JCONVERT /NOCONVERT 
/COPIES=n /COPIES=1 
/[NO]DELETE /NODELETE 
/[NO]JFEED /FEED 
/[NO]JFLAG_PAGES /FLAG_PAGES 
/[NO]TRUNCATE /NOTRUNCATE 
/[NO]WRAP /WRAP 
Prompts 


File: file-specf,...] 


Command Parameters 


file-spec{,...] 

Specifies one or more files to be printed. If you specify more than one file, 
separate the file specifications with commas (,) or plus signs (+). In either case, 
the PRINT command prints all the files as a single print job. You can use 
wildcard characters for the file name, file type, and directory. 


If you do not specify a file type, the PRINT command uses the default file type 
.LST. If you do not specify a device, the PRINT command uses SY:. 


You can also specify a node name as part of the file specification. If you specify a 
file on a remote node, PBS temporarily copies the file into your account, prints it, 
and then deletes it. Note that you cannot use any qualifiers if you specify a node 
name. 
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entry-spec 

The entry-spec specifies the queue and the name of the entry in the format queue- 
name:[PPNlentry-name. The entry-name can contain from one to nine characters. 
If you do not specify a queue, PBS submits the entry on the default print queue. 
If you do not specify an entry-name, PBS assigns the first non-numeric file name 
in the list of specified file-specs, or PRINT if none is found. Your own PPN is the 
default. 


Command Qualifiers 


/AFTER=date-time 

Requests that the file not be printed until a specific time of day or date. See 
Chapter 2 for a description of the standard syntax rules for specifying date and 
time values. 


For example, to have a file named TIBET.MEM start printing after 5:30#PM on 
September 11 (after normal working hours when there are fewer requests for 
listings), specify the date and time as: 


$ PRINT/AFTER=11-SEP:05:30PM TIBET.MEM 


If the specified date or time has already passed, the file is queued for printing as 
soon as possible. 


/FORMS=form-name 

Specifies the name of the form required for the specified file(s). You specify the 
forms type with an alphanumeric name defined by the system manager. Check 
with the system manager to learn which form names you can specify. 


/HOLD 

Specifies that the entry be placed in a HOLD state on the queue. Entries 
in a HOLD state are not processed until you release them with the SET 
ENTRY/RELEASE command. 


/JOB_COUNT=n 
Requests that the entire job be printed n times, from 1 to 255. By default, the job 
is printed once. 


The following example prints four copies of a file named AFGHAN.TXT: 


$ PRINT/JOB COUNT=4 AFGHAN. TXT 


/JOB_COUNT differs from the /COPIES qualifier in the order in which multiple 
files are printed. For example, if you request three copies of files INDIA.TXT and 
MARCH.FIL, the /JOB_COUNT qualifier prints one copy of INDIA.TXT, followed 
by one copy of MARCH.FIL, and repeats the grouping until three copies of each 
file are printed: 


$ PRINT/JOB_ COUNT=3 INDIA. TXT,MARCH.FIL 


/NAME=entry-name 

Specifies the 1 through 9 character name assigned to the entry. You can display 
the entry-name with the SHOW ENTRY command. In addition, PBS prints the 
entry-name on the first page (also known as the flag, or banner, page) of the hard 


copy. 


/NOTIFY 

/NONOTIFY 

Specifies whether your terminal session is notified of events that occur related to 
your print entry. The default is /NONOTIFY. 
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/OWNER2[p,pn] 

Indicates the owner of the print job. PBS displays the project-programmer 
number on the job header page. You can only specify jobs with your own PPN 
(the default), unless you have sufficient privilege to specify others. 


/PAGE_LIMIT=n 

/PAGE_LIMIT=UNLIMITED 

Specifies the maximum number of pages to be printed in the job. You can specify 
only up to the maximum page limit assigned to the queue by the system manager. 


You can specify /PAGE_LIMIT=UNLIMITED only if the queue’s maximum page 
limit is also set to UNLIMITED. 


/PRIORITY=n 

Specifies the priority of the print job, in the range 1 through 255. The PRINT 
command processes entries in priority order: higher-priority entries before 
lower-priority entries. 

You cannot specify a priority higher than the maximum priority assigned to the 
queue by the system manager. 


/QUEUE=queue-name[:] 
Specifies the name of the queue on which the entry is placed. The queue you 
specify must be a print queue. 


If you do not specify a queue-name in the entry-spec or if you do not specify 
/QUEUE, PBS places the entry on the default print queue. 


Use the SHOW ENTRY command to verify an entry’s position in the queue. 


File Qualifiers 


/CONVERT 

/NOCONVERT 

Specifies whether all zeros should be converted to the letter O before printing. 
The default is /(NOCONVERT. 


/COPIES=n 

Specifies the number of copies to print. By default, the PRINT command prints 
one copy of a file; you can use /COPIES to request up to 255 copies. For example, 
the following command line requests three copies of file INDIA.TXT: 


S$ PRINT/COPIES=3 INDIA.TXT 


If you specify /COPIES after the PRINT command name, each file is printed 
the number of times you specify. For example, to print three copies each of 
BOMBAY.TXT and LAHORE.MEM, type: 


S$ PRINT/COPIES=3 BOMBAY.TXT, LAHORE.MEM 


If you specify /COPIES after a file specification, PBS prints only that file the 
specified number of times. The following command line requests two copies 
of NEPAL.DAT, one copy of SIKKIM.DAT (by default), and five copies of 
BHUTAN.DAT: 


S$ PRINT NEPAL.DAT/COPIES=2, SIKKIM.DAT, BHUTAN .DAT/COPIES=5 


The /COPIES qualifier differs from /JOB_COUNT in the order in which multiple 
files are printed. For example, if you request three copies of files TEXAS.DAT and 
MARCH.FIL, PBS prints three copies of TEXAS.DAT, followed by three copies of 
MARCH.FIL. 


S$ PRINT/COPIES=3 TEDFOR.BOB, MOODY.JON 


Print/Batch Services 7-5 


/DELETE 
/NODELETE 
Controls whether files are deleted after printing. /NODELETE is the default. 


If you specify /DELETE after the PRINT command name, all files specified are 
deleted after printing. For example: 


$ PRINT/DELETE OUTPUT.DAT, RESULT. TXT 
Both OUTPUT.DAT and RESULT.TXT are deleted after printing. 


If you specify /DELETE after a file-spec, only that file is deleted after printing. 
For example: 


$ PRINT CONCRD.MAS, LOWELL.MAS/DELETE, BOXBRO.MAS 
Only the file LOWELL.MAS is deleted after printing. 


You must have write access to the file to delete it after printing, 


/FEED 

/NOFEED 

Specifies whether the printer should leave six blank lines at the end of each page. 
The default is /FEED. 


/FLAG_PAGES 

/NOFLAG_PAGES 

Specifies whether flag (file header) pages should be printed at the beginning of 
each file listing. If you specify /FLAG_PAGES, the number of flag pages printed 
is determined by the system manager, and may vary according to the form you 
specify with the /FORMS qualifier. 


/TRUNCATE 

/NOTRUNCATE 

Indicates whether lines that exceed the width of the page should be truncated. 
The system manager determines the page width; it may vary according to the 
form you specify with the /FORMS qualifier. 


The default is /NOTRUNCATE, which means that lines exceeding the form width 
continue, or "wrap, onto the next line. 


/WRAP 

/NOWRAP 

Indicates whether or not the characters that exceed the form width should print 
on the same line. The default is /WRAP. 
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7.3 Submitting Entries for Batch Processing: SUBMIT 


Format 


The SUBMIT command enters a request for batch processing, either on the 
default batch queue or on a queue you specify. 


When you use the SUBMIT command, you specify one or more command 
procedures to be executed by the batch server. See the RSTS/E Guide to Writing 
Command Procedures for detailed information about writing and executing 
command procedures. 


SUBMIT _ file-specf,...] [entry-spec] 


Command Qualifiers Defaults 

/AFTER=date:time See discussion 

/CPU_LIMIT=n See discussion 

/CPU_LIMIT=UNLIMITED See discussion 

/HOLD none 

/[NO]LOG_DELETE /NOLOG_DELETE 

/[NO]LOG_FILE=file-spec See discussion 
/[NO]LOG_QUEUE=queue-name /NOLOG_QUEUE 

/NAME<=entry-name none 

/[NO]NOTIFY /NONOTIFY 

/OWNER=ppn See discussion 
/PARAMETERS=(parameter{....]) none | 
/PRIORITY=n none | 
/QUEUE=queue-name none | 
/TIME_LIMIT=n See discussion | 
/TIME_LIMIT=UNLIMITED See discussion 

File Qualifiers Defaults 

/[NO]DELETE /NODELETE 

Prompts 


File: file-specf,...] 


Command Parameters 


file-spec 

Specifies one or more command files (procedures) to be submitted for batch job 
execution. You must specify a file name. If you do not specify a file type, PBS 
assumes a default file type of .COM, and if you do not specify a device, PBS 
assumes the default device _SY:. Wildcards are allowed. 


You can only submit files to which you have read access. For each file-spec in 
the SUBMIT command, PBS attempts to find at least one file to which you have 
read access; if it finds none, PBS displays an error message and refuses the batch 
request. If you specify the /DELETE qualifier with a file-spec, you must have 
both read and write access. 
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entry-spec 

The entry-spec specifies the queue and the name of the entry in the format queue- 
name:[PPNlentry-name. The entry-name can contain from one to nine characters. 
If you do not specify a queue, PBS submits the entry on the default batch queue. 

If you do not specify an entry-name, PBS assigns the first non-numeric file name 

in the list of file-specs, or BATCH if none is found. Your own PPN is the default. 


Command Qualifiers 


/AFTER=date:time 
Specifies a date:time value after which the entry is eligible for batch processing. 
If you do not specify this qualifier, PBS assumes the entry is immediately eligible. 


If you specify only a time value, PBS assumes today’s date. If you specify only a 
date value, PBS assumes the end of the day (11:59 p.m.). 


/CPU_LIMIT=n 

/CPU_LIMIT=UNLIMITED 

Specifies the maximum CPU time, in minutes, allowed for your batch job. This 
limit applies to the entire batch job, not to each command procedure within the 
job. You can only specify the maximum CPU limit of the batch request’s queue. 


If you specify /CPU_LIMIT=UNLIMITED, the batch request’s queue must 
also have its maximum CPU limit set to UNLIMITED. A batch request with 
CPU_LIMIT=UNLIMITED is allowed an infinite amount of CPU usage during 
processing. 


If you do not specify this qualifier, PBS assigns the batch queue’s default CPU 
limit. 


/HOLD 

Specifies that the entry be placed in a HOLD state on the queue. Entries 
in a HOLD state are not processed until you release them with the SET 
ENTRY/RELEASE command. 


/LOG_DELETE 

/NOLOG_DELETE 

Specifies whether the log file should be deleted after printing. The default is 
/NOLOG_DELETE. 


/LOG_FILE [=file-spec] 

/NOLOG_FILE 

Specifies whether a log file is created for the batch job and if so, the file-spec of 
the log. By default, PBS creates a log file at the start of a batch job. 


If you do not specify a file-spec, PBS creates the log file in your own account on 
the default device SY:, using the first six characters of the entry name and a file 
type of .LOG. (Any file with the same name will be replaced.) 


If you specify a file-spec, PBS creates that file at the start of the batch job, 
replacing any file having the same name. 


/LOG_QUEUE [=queue-name] 

/NOLOG_QUEUE 

Specifies whether a log file should be queued for printing when the batch job 
completes and if so, the queue on which it should be printed. The default is 
/NOLOG_QUEUE. 


If you do not specify a queue name, PBS queues the log file on the default print 
queue. 
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/NAME=entry-name 
Specifies the one- to nine-character name assigned to the entry. 


/NOTIFY 

/NONOTIFY 

Specifies whether or not your terminal session is notified of events that occur 
related to your batch entry. The default is /NONOTIFY. 


/OWNER=ppn 
Indicates the owner of the batch job. You can only specify your own PPN, unless 
you have sufficient privilege to specify others. 


/PARAMETERS=(parameterf,...]) 

Specifies from one to eight optional parameters to be passed to the batch job. 
PBS assigns the parameters to the local symbols P1 through P8 when it executes 
the first command procedure in the job. 


/PRIORITY=n 

Specifies the priority of the batch request, in the range 1 to 255. PBS processes 
entries with higher priorities before those with lower priorities. You cannot 
specify a priority higher than the queue’s maximum. 


/QUEUE=queue-name[:] 
Specifies the name of the queue on which the entry is placed. The queue specified 
must be a batch queue. 


Use the SHOW ENTRY command to verify an entry’s position in the queue. 


/TIME_LIMIT=n 

/TIME_LIMIT=UNLIMITED 

Specifies the maximum elapsed time, in minutes, allowed for the requested batch 
job. This limit applies to the entire batch job, not to each command procedure 
within the job. You can only specify the maximum time limit of the batch 
request’s queue. | 


If you specify /TIME_LIMIT=UNLIMITED, the batch request’s queue must 

also have its maximum time limit set to UNLIMITED. A batch request with 
TIME_LIMIT=UNLIMITED is not limited to any amount of elapsed time during 
processing. 


If you do not specify this qualifier, PBS assigns the batch queue’s default time 
limit. 


File Qualifiers 


/DELETE 
/NODELETE 
Specifies whether the command file should be deleted after batch processing 


completes. You must have write access to the file for which you specify /DELETE. 
The default is /(NODELETE. 


You may type the /DELETE qualifier after any file name to delete only that file, 
or you may type the /DELETE qualifier immediately after the SUBMIT command 
to delete all files included in the command. 
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7.4 Displaying Print and Batch Queue Entries: SHOW ENTRY 


The SHOW ENTRY command displays information about entries in the print 
or batch queue. This display shows each entry’s current status as well as its 
characteristics, such as queue-name, entry-name, entry-number, owner, and 
priority. 


Format 
SHOW ENTRY § [eniry-spec or entry-number] 
Command Qualifiers Defaults 
/ALL See discussion 
/BATCH See discussion 
/BRIEF /BRIEF 
/FILES /BRIEF 
/FULL /BRIEF 
/[NOJOUTPUT(=filespec] See discussion 
/PRINT | none 
/STATUS[=(keywordJ,...]) none 


Command Parameters 


entry-spec 

entry-number 

Specifies the entry-spec or entry-number of the entry you want to display. Use the 
entry-number when you want to display a single entry. Use the full entry-spec 
(queue:[ppn]|name) to display all entries meeting the specification. 


You can specify wildcard characters anywhere in the entry-spec. If you do not 
specify any entry parameter, the SHOW ENTRY command displays all print and 
batch entries owned by you. 
NOTE 
By default, PBS does not display entries by queue. To see a list of the 
entries in a particular queue, specify the queue-name in the entry-spec. 
Command Qualifiers 


/ALL 

Specifies that all entries are to be displayed. Using the /ALL qualifier is the same 
as specifying the entry-spec *:[*,*]*, although you may include other qualifiers to 
restrict the entries selected. 


If you do not specify /ALL, the entry-spec defaults to entries with your PPN. 


/BATCH 
Specifies that only batch queue entries be displayed. This qualifier conflicts with 
/PRINT. 


The default is that both print and batch queue entries are displayed. 


7-10 Print/Batch Services 


/BRIEF 
Requests a brief listing of information about entries in the queue. It is the 
default. For example: 


$ SHOW ENTRY/BRIEF <RET> 


Entry Pos Type Queue Owner Name Status Pri 


3686 1st Batch BASELEVEL [ 1,170] BLDMGR STARTED 255 
The /BRIEF qualifier displays the following information about each entry: 
e Entry number 
e Position — the entry’s start position relative to other entries 
e Entry type — Print or Batch 
¢ Queue name 
¢ Owner’s PPN 
e Entry name 
e Entry status — one of the following: 

— READY -— The entry is ready for processing. 


— AFTER — The entry is waiting for an /AFTER date and time to be met 
before it can start processing. 


—- HOLD — The entry is waiting for a SET ENTRY/RELEASE command in 
order to start processing. 


— STARTED —- The entry has started processing. (Use the /FULL qualifier 
to display the date and time that the entry started.) 


— ABORTING — The entry is in the process of being terminated. 
e Priority in the queue 
/FILES 


Displays all file-specs, and their qualifiers, included in the entry. Unless you have 
additional privilege, you can only see the file-specs contained in your own entries. 


/FULL 
Displays the full status of each entry. In addition to all the information shown by 
the /BRIEF and /FILES qualifiers, the /FULL qualifier also displays the following: 


e §=6©Priority 

¢ JOB_COUNT (number of copies to be printed) 

¢ Date and time the entry was submitted 

e Date and time the entry was last modified (if ever) 

e Date and time the entry started processing 

e AFTER date and time (specified by the /AFTER qualifier) 
e Server name (if the job is STARTED) 
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For example: 


S SHOW ENTRY/FULL <RET> 


3686 1st 


Type Queue Owner Name Status Ped. 


Batch BASELEVEL [ 1,170] BLDMGR 


STARTED 200 


Entered 19-Jun-90 08:23 AM 
Started 19-Jun-90 11:25 AM on batch server BA9: 
CPU limit UNLIMITED, Time limit UNLIMITED 
Log file SY:[1,170]BLDMGR.LOG, No log queue 
No parameters 
1>  DU13:[170,59]BLDMGR.COM 


/OUTPUT[=filespec] 


/NOOUTPUT 


Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 


/PRINT 


Displays only entries on print queues. 


/STATUS[=(keyword[,...])] 
Displays all of the entries in PRINT or BATCH queues with the specified status 
that are currently being processes or waiting to be processed. 


The /STATUS qualifier accepts one or more status keyword arguments. If you 
specify multiple status keywords, then SHOW ENTRY displays those entries with 
any of the specified status. 


For example, the command: 


S$ SHOW ENTRY/ALL/STATUS=FORMS WAIT 


displays all (print) entries that are waiting for a forms change. The command: 


S$ SHOW ENTRY/ALL/STATUS=(HOLD, AFTER) 


displays entries that are on hold or waiting for their after date/time to expire. 
See Table 7—2 for a list of the (STATUS keywords and their meaning: 


Table 7-2: /STATUS Keywords 


Keyword 
AFTER 


ABORTING 


FORMS_WAIT 


HOLD 


READY 
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Meaning 


Displays entries with the status AFTER, indicating they are waiting 
for their specified after date/time to elapse. 


Displays entries with the status ABORTING, indicating they have 
started but are in the process of being terminated. 


Displays (print) entries with the status FORMS_WAIT, indicating 
they are waiting for their required form to be installed on an 
assigned print server. 


Displays entries with the status HOLD, indicating they can- 
not start until they are taken off HOLD status via the SET 
ENTRY/RELEASE command. 


Displays entries with the status READY, indicating they are waiting 
for a Print or Batch server to become available for processing. 


(continued on next page) 


Table 7-2 (Cont.): /STATUS Keywords 
Keyword Meaning 


STARTED Displays entries with the status STARTED, indicating they are 
currently being processed by a Print or Batch server. 


NOTE 


For compatibility with VMS, RSTS/E also supports the VMS SHOW 
ENTRY qualifier /BY_JOB_STATUS and most of its keyword ar- 
guments. See Table 7-3 for the RSTS/E keywords and their VMS 


synonyms: 


Table 7-3: VMS /BY_JOB_STATUS Synonyms 


RSTS/E Syntax VMS Synonym 

$ SHOW ENTRY/STATUS $ SHOW ENTRY/BY_JOB_STATUS 
=ABORTING none 

— =AFTER =TIMED_RELEASE 

=FORMS_ WAIT none 
=HOLD =HOLDING 
=READY =PENDING 
=STARTED =EXECUTING 


Print/Batch Services 7-13 


7.5 Modifying a Print or Batch Queue Entry: SET ENTRY 


The SET ENTRY command modifies one or more attributes of an entry. You also 
use SET ENTRY to hold or release an entry for processing. 


Format 
SET ENTRY enitry-spec or entry-number 
Command Qualifiers Defaults 
/[NO]JAFTER=date:time none 
/ALL See discussion 
/BATCH none 
/CPU_LIMIT=n none 
/CPU_LIMIT=UNLIMITED none 
/FORMS=form-name See discussion 
/HOLD none 
/JOB_COUNT=n none 
/PAGE_LIMIT=n none 
/PAGE_LIMIT=UNLIMITED none 
/PRINT See discussion 
/PRIORITY=n none 
/RELEASE none 
/TIME_LIMIT=n none 
/TIME_LIMIT=UNLIMITED none 
Prompts 


Entry: entry-spec or entry-number 


Command Parameters 


entry-spec 

entry-number 

Specifies either the entry-spec or entry-number of the print or batch entry to be 
modified. If you specify the entry-spec, PBS modifies all entries matching the 
specification. If you specify the entry-number, PBS modifies only the entry with 
the matching number. Wildcards are allowed. 


Command Qualifiers 


/AFTER=date:time 

/NOAFTER 

Specifies a date:time value after which the entry is eligible for printing or batch 
processing. 


If you specify only a time value, PBS assumes today’s date. If you specify only a 
date value, PBS assumes the end of the day (11:59 p.m.). 
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For example, you type the following command line to have a job named BOCAT 
printed after March 2 at 1:00 in the afternoon: 


S$ SET ENTRY BOCAT/AFTER=02-JUN-90:01:00PM 


The /NOAFTER qualifier releases an entry (previously set with the /AFTER 
qualifier) for immediate processing. 


/ALL 

Specifies that all of your entries are to be modified. Using the /ALL qualifier is 
the same as specifying the entry-spec *:[*,*]*, although you may include other 
qualifiers to restrict the entries selected. 


/BATCH 
Specifies that only batch queue entries be modified. 


By default, both print and batch queue entries are selected to be changed. 


/CPU_LIMIT=n 

/CPU_LIMIT=UNLIMITED 

(Batch entries only.) Specifies the maximum CPU time, in minutes, allowed for 
the batch job. This limit applies to the entire batch job, not to each command 
procedure within the job. 


If you specify /CPU_LIMIT=UNLIMITED, the batch request’s queue must 
also have its maximum CPU limit set to UNLIMITED. A batch request with 
CPU_LIMIT=UNLIMITED is allowed an infinite amount of CPU usage during 
processing. 


/FORMS=form-name 
(Print entries only.) Specifies the name of the form required by the entry. See 
your system manager to find out which form names you can specify. 


/HOLD 

Specifies that the entry be placed in a HOLD state on the print or batch queue. 
PBS does not process entries in a HOLD state until you release them with the 
SET ENTRY/RELEASE command. 


/JOB_COUNT=n 
(Print entries only.) Specifies that the entire job be printed n times, from 1 to 
255. 


/PAGE_LIMIT=n 

/PAGE_LIMIT=UNLIMITED 

(Print entries only.) Specifies the maximum number of pages to be printed in the 
job. You can specify only up to the maximum page limit assigned to the queue by 
the system manager, unless you have sufficient privilege to specify a higher limit. 


You can specify /PAGE_LIMIT=UNLIMITED only if the queue’s maximum page 
limit is also set to UNLIMITED. 

/PRINT 

Specifies that only print queue entries be modified. 

The default is that both print and batch queue entries are selected to be changed. 
/PRIORITY=n 

Specifies the priority of the print or batch request, in the range 1 to 255. PBS 


processes entries with higher priorities before those with lower priorities. You 
cannot specify a priority higher than the queue’s maximum. 
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/RELEASE 
Specifies that an entry previously placed in a HOLD state be released. 


/TIME_LIMIT=n 

/TIME_LIMIT=UNLIMITED 

(Batch entries only.) Specifies the maximum elapsed time, in minutes, allowed 
for the requested batch job. This limit applies to the entire batch job, not to each 
command procedure within the job. 


If you specify /TIME_LIMIT=UNLIMITED, the batch request’s queue must 

also have its maximum time limit set to UNLIMITED. A batch request with 
TIME_LIMIT=UNLIMITED is not limited to any amount of elapsed time during 
processing. 
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7.6 Deleting a Print or Batch Entry from a Queue: DELETE/ENTRY 


Format 


The DELETE/ENTRY command uses the name or number of an entry to cancel a 
request to the print or batch queue. 


DELETE/ENTRY  eniry-spec or entry-number 


Command Qualifiers Defaults 

/ALL none 

/BATCH See discussion 
/PRINT See discussion 
Prompts 


Entry: entry-spec or entry-number 


Command Parameters 


entry-spec 

entry-number 

Specifies either the entry-spec or entry-number of the print or batch entry to 
be deleted. If you specify the entry-spec, PBS deletes all entries matching the 
specification. If you specify the entry-number, PBS deletes only the entry with 
the matching number. Wildcards are allowed. 


NOTE 
Be careful when you delete jobs using the entry-spec parameter. More 
than one entry with the same entry-spec may exist. 
Command Qualifiers 


/ALL 

Specifies that all of your entries are to be deleted. Using the /ALL qualifier is 
the same as specifying the entry-spec *:[*,*]*, although you may include other 
qualifiers to restrict the entries selected. 


/BATCH 
Specifies that only batch queue entries be deleted. 


The default is that both print and batch queue entries are selected. 


/PRINT 
Specifies that only print queue entries be deleted. 


The default is that both print and batch queue entries are selected. 
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7.7 Displaying a Queue’s Characteristics: SHOW QUEUE 


The SHOW QUEUE command displays the status of one or more print or batch 
queues. The display includes information about the queue’s characteristics, such 
as default form name, size limits, and the servers assigned to the queue. 


Format 
SHOW QUEUE gqueue-name[:] 
Command Qualifiers Defaults 
/ALL none 
/BATCH See discussion 
/BRIEF /BRIEF 
/FULL /BRIEF 
/[NOJOUTPUT[=filespec] none 
/PRINT See discussion 
| Prompts 


Queue: queue-name|[:] 


Command Parameters 

queue-name [:] 

Specifies the name of the queue to be displayed. Wildcards are allowed. 
Command Qualifiers 

/ALL 

Specifies that all queues be displayed. 

/BATCH 

Specifies that only batch queues be displayed. 


The default is to display all queues matching the queue-name parameter, 
regardless of type. 


/BRIEF 
Specifies a brief display (the default), which includes the following information 
about the specified queue: 


e Queue type — Print or Batch 
¢ Queue name 
© Queue status — one or more of the following: 
— DEFAULT — Queue is the default queue. 
—- OPEN — Queue can accept requests. 
—- CLOSED — Queue will not accept requests. 
— STARTED — Entries on the queue can be started. 
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—- STOPPED —- Entries on the queue cannot be started. 


—- MARKED FOR DELETION — Queue will be deleted as soon as it 
becomes empty. 


/FULL 
Specifies a full display, which includes all the information in the brief (default) 
display, along with the following additional information: 


° Default form name (Print queues only) — The name assigned to the default 
paper form in the printer. 


¢ Default/maximum priority — The default priority assigned to entries in the 
queue and the maximum priority that can be specified for entries. 


e Default/maximum page limit (Print queues only) — The default page limit 
assigned to entries in the queue and the maximum page limit that can be 
specified for entries. 


° Default/maximum CPU limit (Batch queues only) — The default CPU limit 
assigned to entries in the queue and the maximum CPU limit that can be 
specified for entries. 


¢ Default/maximum time limit (Batch queues only) — The default time limit 
assigned to entries in the queue and the maximum time limit that can be 
specified for entries. 


e Assigned servers — The list of print and batch servers currently assigned to 
the queue. 


/OUTPUT[=filespec] 

/NOOUTPUT 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 


/PRINT 
Specifies that only print queues be displayed. 


The default is to display all queues matching the queue-name parameter, 
regardless of type. 
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Chapter 8 


Program Development 


This chapter describes DCL commands for developing, linking, and running 
programs on RSTS/E. 


NOTE 


This manual does not explain programming concepts. To use this 
chapter, you need to know how to write programs in the language you 
select. See the appropriate programming manuals for information 
about using each language. 


Table 8-1 describes the commands you use to develop programs on RSTS/E. 


Table 8-1: Program Development Commands 


Command Function 


Programming Languages and Environments 


BASIC Invokes the BASIC-PLUS or BASIC-PLUS-2 programming environment, 
depending on the qualifiers you use or the default set by your system 
manager. 

CC Compiles PDP11-C programs. 

COBOL Compiles COBOL-81 programs. 

DIBOL Compiles a DIBOL-11 program. 

FORTRAN Compiles a FORTRAN program. Two compilers are available: 


FORTRAN-IV and FORTRAN-77; depending on the qualifiers you 


use or the default set by your system manager. 
MACRO Assembles a program written in MACRO-11. 


Programming Operations 
LINK Links together object files to produce an executable file. 


RUN Executes a system or user program. 


8.1 Developing Programs on RSTS/E 


You can develop programs on RSTS/E using a variety of techniques and lan- 
guages. BASIC-PLUS (supplied with all RSTS/E systems) is highly interactive, 
and provides a self-contained programming environment. 


BASIC-PLUS is an interpreted language. As you enter lines of source code into 
the system, BASIC-PLUS immediately translates them into code that the system 
can execute. Thus, you can run a program right after you finish entering it. 
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Other high-level languages (such as BASIC-PLUS-2, CC, COBOL, DIBOL, and 
FORTRAN) are compiled languages, generating PDP-11 object code. To develop 
programs in these languages, you must create a source program, then compile it 
and link it before it can be run. 


In addition, the MACRO-11 assembler (supplied with all RSTS/E systems) 

lets you write programs that correspond line-for-line with PDP-11 machine 
instructions. You follow the same general steps to develop MACRO programs as 
you do for compiled languages. 


BASIC-PLUS and BASIC-PLUS-2 are command environments on RSTS/E. This 
means that you can switch from DCL command level to a BASIC environment, 
which has its own prompt for accepting your input. (The BASIC-PLUS prompt 
is "Ready." The BASIC-PLUS-2 prompt is usually "BASIC2," depending on what 
your system manager has specified.) By contrast, you develop programs in some 
other languages by using DCL commands. 


The number and type of programming tools available on any given RSTS/E 
system (as well as the language you choose for any given application) depend 
on many factors. These factors include: the size of the system; its cost; and the 
application environment. 


The following is an overview of the program development cycle for compiled 
languages — that is, those RSTS/E languages other than BASIC-PLUS. For 
information about programming in a specific language (including sample 
programs and procedures), see the appropriate language manual. 


8.2 Overview 


RSTS/E offers a number of different languages for program development. 
Although each language is unique, you use a similar process when developing any 
program that you compile. 


Briefly, the major steps are: 

Design — Planning and initial coding. 

Edit — Entering code into a source file. 

Compile — Compiling or assembling source code into an object file. 


Link — Combining object files into an executable file. 
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Test — Making trial runs of an executable file and finding errors. 


The next four sections introduce the tools you use for the edit, compile, link, 
and test steps. The commands you use in each step depend on the programming 
language you select. 


8.2.1 Editing 


A source program is a file containing text; this is the form of your program that 
you actually write. The text in a source program consists of statements in BASIC, 
CC, COBOL, DIBOL, FORTRAN, MACRO, or some other high-level language. 


You generally use an editor such as EDT (which you invoke with the EDIT 
command) to create a file containing the text of your source statements. An editor 
allows you to type lines of the program and save it as a file. When you have 
entered the program lines into the file the way you want them, you are ready for 
the compile step. 
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8.2.2 Compiling 


There is a command for compiling each high-level language. The compiler: 
1. Reads the source-code file you have created with your editor 
2. Compiles it into PDP-11 machine code 


3. Writes the compiled machine code into an object file 


On PDP-11 systems, the object output is called a "module"; it contains your 
program in the binary language that, when linked, is executable by a PDP-11 
computer. 


A single line of source code, especially in a high-level language, may be compiled 
into many PDP-11 instructions. The efficiency (and improved clarity) of not 
having to write machine instructions a line at a time is one of the important 
reasons for using a high-level language. 


MACRO is called an "assembler." For this discussion, its function is the same as 
that of any compiler. MACRO turns source code into object code, and it fits into 
the program development cycle the same way as do the compilers. 


In addition, the MACRO assembler can produce a listing that shows both your 
source code and the generated object code. This listing, like other listings 
prepared by compilers, is helpful during the debugging process. 


Another listing that is useful in debugging is the "cross-reference" listing. This 
listing shows where each symbol is referenced in your source program. For the 
MACRO assembler, you can request this cross-reference as part of the assembler’s 
program listing. For some of the other languages, there are separate programs 
that operate independently of the compilers to produce cross-reference listings. 
For example, BASIC-PLUS has BPCREF; BASIC-PLUS-2 has B2CREF. 


8.2.3 Linking 


A program that is ready for execution by the system is called an executable file. 
(Other terms for executable file are save image, task, or load module.) 


To prepare an executable file from your object module, you must link it. Linking 
a program into an executable file performs three major functions: 


¢ Combination of modules — You can link several separately compiled object 
files together into a single executable file. 


e Relocation of addresses — Because the assignment of actual memory locations 
for any object module must depend on the other object modules which go into 
the load module with it, the link step is the time when references to absolute 
memory locations are fixed. 


¢ Other object modules — You can incorporate modules that the system 
supplies into your executable file. Each high-level language requires certain 
object modules to be linked into executable files for programs written in that 
language. 
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8.2.3.1 Combining Modules 


There are two main reasons why you want to be able to link an executable file 
from separately compiled object modules: 


e If your program is complex, it is helpful to be able to compile it in several 
smaller pieces as opposed to one large program. During debugging, you can 
then recompile only the smaller piece that you have changed before linking a 
new executable file for further testing. 


e¢ You can link subroutines into a main program. You do so by maintaining 
a library of subroutines from which the linker can extract object modules. 
Therefore, you can reduce repetitious source coding in your main program. 


The use of subroutines also allows you to write the main portion of your pro- 
gram in one language, and other portions in another. For example, when 
writing a main program in FORTRAN, you might also want to code a special 
or performance-sensitive subroutine in MACRO. 


8.2.3.2 Relocating Addresses 


The final location of an object module.in a linked executable file cannot be 
determined until the object modules are combined during linking. Therefore, 
object modules are relocatable. In addition to binary machine instructions, an 
object module contains tables of information that direct link-time operations, such 
as address relocation. 


Note that the linker can optionally produce a listing of resolved addresses, called 
a map. 


8.2.4 Testing 


You can rarely create a program that does not contain at least one error, either 
in its logic or in its coding. You may discover errors while you are editing the 
program. Furthermore, the compiler may find errors during the compilation 
process. The compiler informs you of any errors it finds by using error flags 

in the listings. The linking process may also catch certain errors and issue 
appropriate messages. 


However, often you do not discover that the program does not work properly until 
you run your program. Some programming errors are difficult to find. For this 
reason, special debugging tools are supplied with most high-level languages. See 
the appropriate programming language manual for information about available 
debugging tools. 


8.3 The RIT11 and RSX Tools 


Most of the high-level languages available on RSTS/E are very similar to corre- 
sponding languages on RT-11 or RSX-11. Therefore, the program development 
commands you use on RSTS/E are similar to the RT11 and RSX program 
development commands. 


For example, when you develop a FORTRAN-IV program on RSTS/E, you use 
commands similar to those on RT11. When you develop a program in other 
high-level languages (including FORTRAN-77, but excluding BASIC-PLUS), you 
use commands similar to those on RSX. You can develop MACRO-11 programs 
using either set of program development commands. 
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The description of the program development cycle stated earlier applies to the 
commands for either RT11 or RSX. However, the appropriate command for each 
programming environment is unique: there is one set of commands for RT11, and 
another set for RSX. 


Table 8—2 shows the two sets of commands. 


Table 8-2: Program Development Commands for RT11 and RSX 


Generic Name RT11 Command RSX Command 
C - CC 
LINK/CC 
COBOL - COBOL 
DIBOL - DIBOL 
FORTRAN FORTRAN/FOR FORTRAN/F77 
MACRO MACRO/RT11 MACRO/RSX11 
Linker LINK/FOR LINK/F77 
LINK/RT11 LINK/C81 
LINK/DIBOL 
LINK/RSX11 
LINK/BP2 
LINK/CC 


The file types assigned to executable files are .SAV for the RT11-based linker 
and .TSK for the RSX-based linker. The file type of object files is .OBJ in either 


environment. 


8.3.1 RT11-Based Programming 


You can use RSTS/E’s RT11-based commands to develop programs in either 
FORTRAN-IV or MACRO. Depending on your application, the programs you 
develop can be either: 


e Run directly on your RSTS/E system 
¢ Debugged on RSTS/E, compiled, and run on an RT-11 system 


Using MACRO, you can write programs that use any feature of RSTS/E, or 
programs that use only RT11 monitor directives. 


8.3.2 RSX-Based Programming 


You can use RSTS/E’s RSX-based commands to develop programs in MACRO or 
any of the high-level languages. Depending on your application, your developed 
programs can be either: 


e Run directly on your RSTS/E system 

¢ Debugged on RSTS/E, compiled, and run on an RSX-11 system 

Using MACRO, you can write programs that use any feature of RSTS/E, or 
programs that use only RSX monitor directives. Certain features of RSTS/E are 


also available directly through some high-level languages. (For example, the 
BASIC-PLUS SYS calls, which are also available in BASIC-PLUS-2. ) 
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If you want to use the RMS data management package in your application, you 
will be using RSTS/E’s RSX-based languages. (See RMS documentation for more 
information.) 
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8.4 BASIC 


Format 


The BASIC command places you in the BASIC-PLUS or BASIC-PLUS-2 
programming environment, depending on the qualifiers you use and the system’s 
default. 


In BASIC-PLUS, you can use BASIC-PLUS keyboard monitor commands (for 
program development), or CCL commands. In BASIC-PLUS-2, you can use 
program development commands. 


To return to DCL from the BASIC-PLUS or BASIC-PLUS-2 environment, type: 
$ 

or 

$SWITCH 


See Appendix B, or the appropriate language manual, for details on the com- 
mands you can use in these environments. 


BASIC/BP2 invokes the BASIC-PLUS-2 environment to begin a programming 
session: 


$ BASIC/BP2 <RET> 

The system displays the following prompt for the BASIC-PLUS-2 environment: 
BASIC2 

BASIC/BPLUS invokes the BASIC-PLUS environment: 

$ BASIC/BPLUS <RET> 


The system displays the following prompt for the BASIC-PLUS environment: 


Ready 

BASIC 

Command Qualifiers Defaults 
/BP2 /BP2 
/BPLUS 


Command Qualifiers 


/BP2 
Invokes the BASIC-PLUS-2 programming environment. 


/BPLUS 
Invokes the BASIC-PLUS programming environment. 
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8.5 CC 


The CC command invokes the PDP-11 C compiler to compile C source programs. 


NOTE 


All user input is converted to uppercase unless it is enclosed in 
quotation marks. 


Format 
CC (file-specf,...]) 


Command Qualifiers Defaults 
/[NO]DEFINE=(“identifier[(param,...)] token-string” [,...]) /NODEFINE 
/ENVIRONMENT=([NO]FPU, [NO]PIC) See discussion 
/ENVIRONMENT=NOPIC, FPU 
/[NO]JERROR_LIMIT[=qualifier] 
/ERROR_LIMIT=30 See discussion 
/[NOJINCLUDE_DIRECTORY=(pathname [,...]) See discussion 
/[NO]LIST[=file-spec] /NOLIST 
/[NO]|MACRO[=file-spec] /NOMACRO 
/[NO]JMEMORY[=qualifier] /NOMEMORY 
/[NO]JMODULEs(identifier | "string" [,identifier |"string"]) _ See discussion 


/ERROR_LIMIT=30 


/[NOJOBJECT[=file-spec] 
/SHOW[=option,...] 
/SHOW=(CONDITIONALS, SOURCE) 
/[NO]STANDARD[=(option,...)] 
/[NO]TERMINAL[=[NO]SOURCE] 
/[NO]TITLE=(identifier) 
/[NOJUNDEFINE=(identifierf,...]) 
/[NOJWARNINGS[=(option.,...)] 
/[NOJWORK_FILE_SIZE=integer_number 


PROMPTS 
file-specf,...] 


Command Parameters 
file-spec[,...] 


/OBJECT 

See discussion 
See discussion 
/ANSI 
/NOSOURCE 
/NOTITLE 
/NOUNDEFINE 
/WARNINGS 
See discussion 


One or more PDP-11 C source files separated by plus signs or commas. If 

plus signs are used, the input files are concatenated into a single object file. 

If commas are used, each file is compiled separately to create separate object 
files. If no input file extension is specified, PDP-11 C assumes the .C default file 
extension. 
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Qualifiers indicate special actions to be performed by the compiler or special 
input file properties. Compiler qualifiers can apply to either the CC command 
or to the specification of the file being compiled. When a qualifier follows the 
CC command, it applies to all the files listed. When a qualifier follows the file 
specification, it applies only to the file immediately preceding it. 


Command Qualifiers 


/DEFINE=("identifier[(param,...)] token-string” [,...]) 

/NODEFINE 

Performs the same function as the #define preprocessor directive. That is, 
/DEFINE defines a token string or macro to be substituted for every occurrence of 
a given identifier in the program. All input is converted to uppercase unless it is 
enclosed in quotation marks. 


The simplest form of a /DEFINE definition is: /DEFINE=("TRUE 1") 
This results in a definition the same as: #define TRUE 1 


Macro definitions must be enclosed in quotation marks as in: /DEFINE=("funct(a) 
a+sin(a)") 


This definition produces the same results as: #define funct(a) a+sin(a) 


When more than one /DEFINE is present on the command line or in a single 
compilation unit, only the last /DEFINE is used. When both /DEFINE and 
/UNDEFINE are present in a command line, /DEFINE is evaluated before 
/UNDEFINE. The default is /NODEFINE. 


/ENVIRONMENT=([NO]FPU, [NOJPIC) 

/ENVIRONMENT=(NOPIC,FPU) 

Specifies the type of environment in which the generated code is to execute or the 
type of environment in which the object module is to be linked or both. 


If you specify [NO]JFPU, [NO]PIC, provide at least one value, or an error message 
is generated. 


If FPU is specified or defaulted, FPU instructions are generated as appropriate. 
If NOFPU is specified, FPU instructions are not be generated. 


If you specify PIC, PDP-11 C produces position independent code. If you specify 
or default to NOPIC, non-pic code may be generated. For information on position 
independent code, refer to the related discussion in the PDP-11 MACRO-11 
Language Reference Manual. 


The default is /ENVIRONMENT=(NOPIC,FPU). 


/ERROR_LIMIT[=qualifier] 

/ERROR_LIMIT=30 

/NOERROR_LIMIT 

Indicates the maximum integer error count. If the number of errors encountered 
(exclusive of informationals and warnings) exceeds the integer value specified, the 
compilation is aborted without further source code analysis. 


The default is /ERROR_LIMIT=30. If /NOERROR_LIMIT is specified, compilation 
proceeds regardless of the number of errors encountered. 


/AINCLUDE_DIRECTORY=(pathname [....]) 

/NOINCLUDE_DIRECTORY 

Provides an additional level of search for include files. Each pathname argument 
can be either a logical name or a legal directory specification, in quoted form. 
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The forms of inclusion effected are the #include "file-spec" and #include <file-spec> 
forms. For the quoted form, the order of search is as follows: 


e The directory containing the top level source file 
e The directories specified in the /INCLUDE_DIRECTORY qualifier (if any) 
¢ The current default directory 


For the bracketed form, the order of search is as follows: 

e The directories specified in the INCLUDE_DIRECTORY qualifier Gf any) 

e The directory or search list of directories specified in the logical name, CLB 
e The directory specified by CC$: 


The default is /NOINCLUDE_DIRECTORY. 


/LIST[=file-spec] 

/NOLIST 

Controls whether a listing file is produced. The default output file extension is 
.LST. The default is /NOLIST. 


/MACRO[sfile-spec] 

/NOMACRO 

Controls whether a macro listing file is produced. The default output file 
extension is .MAC. A legal MACRO-11 source program corresponding to the 
translation of the source program is placed in the specified file. 


Note that the /MACRO qualifier differs from the /SHOW=MACHINE_CODE 
qualifier as follows: 


¢ The /MACRO qualifier places a MACRO-11 source program in a separate file 
rather than the listing file 


¢ The MACRO-11 source program may be assembled under MACRO-11 without 
modification 


e The /SHOW=MACHINE_CODE qualifier places a machine code listing similar 
to the list file output by MACRO-11 into the listing file. The machine code 
listing cannot be directly assembled under MACRO-11 


The default is /NOMACRO. 


/MEMORY[=qualifier] 

/NOMEMORY 

Determine the amount (in 8Kb regions) of extended memory to allocate in a 
PDP-11 host environment. 


The specified integer value determines the number of 8192-byte regions which 
are to be allocated. An integer between 0 and 512 may be specified to allocate up 
to the 4Mb architectural limit of the PDP-11. 


If the specified amount of extended memory is not available or if the specified 
value exceeds the maximum size established by the system manager when PDP- 
11 C is installed, the largest number of available 8192 byte regions which does 
not exceed the installation maximum are allocated. 


In general, the greater amount of extended memory allocated, the less work file 
activity, and the faster the performance of the compiler. /NOMEMORY is the 
default and is equivalent to /MEMORY=0. The default value is the maximum size 
determined during installation of PDP-11 C. 
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/MODULE=(identifier | “string” [,identifier | “string’]) 
/MODULE=("last-file-spec-name", ''V1.0") 

Controls the compiler produced output module header for the program file. This 
qualifier will accept a maximum of two string values, and you must supply at 
least the first string value. 


The last-file-spec-name is the last file name specified for a given compilation unit. 
The default is MODULE=(‘last-file-spec-name","V1.0"). 


/OBJECT[=file-spec] 

/OBJECT 

Controls whether a object file is produced. The output file extension is .OBJ. The 
default is /OBJECT. 


/SHOW[=(option....)] 

/SHOW=(CONDITIONALS,SOURCE) 

Used with the /LIST qualifier to set or cancel specific listing options. You can 
select the following options: 


e ALL 
Print all listing information. 


e [NO]CONDITIONALS 
Specifying /SHOW=CONDITIONALS causes conditional program segments 
that were not compiled (due to #if type preprocessing directives) to appear 
in the listing. Specifying /SHOW=NOCONDITIONALS causes conditional 
program segments that were not compiled to be omitted in the listing, The 
default is /SHOW=CONDITIONALS, or as established during installation of 
PDP-11 C. 


NOTE 


The /SHOW=[NO]CONDITIONALS qualifier is similar to the same 
qualifier used by DIBOL and MACRO-32. 


e [NO]JEXPANSION 
Specifying /SHOW=EXPANSION causes final macro expansions to be printed 
in the program listing. Specifying this option, causes the macro nesting level 
of the last macro expanded on the line to print next to each line. The default 
is /SHOW=NOEXPANSION. 


e [NO]JINCLUDE 
Specifying /INCLUDE causes the contents of #include files to be printed. The 
default is /SHOW=NOINCLUDE. 


e [NO]JINTERMEDIATE 
Specifying /INTERMEDIATE causes the intermediate macro expansions in 
the program listing to be printed. The default is /SHOW=NOINTERMEDIATE. 


° NONE 
No listing information is printed. 


e [NOJMACHINE_CODE 
Specifying (SHOW=NOMACHINE_CODE directs the compiler to NOT list the 
generated machine code in the listing file. The default is SSHOW=MACHINE_ 
CODE. 


e [NO]SOURCE 
Specifying /NOSOURCE causes the source file statements not to be printed. 
The default is /SHOW=SOURCE. 
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/STANDARD[=(option....)] 

/NOSTANDARD 

Determines what language features is allowed, or flagged as nonstandard. One of 
the following values may be specified: 


e ANSI 
e /NOSTANDARD implies PDP-11 C native syntax and semantics 


e /STANDARD=ANSI implies ANSI C standard syntax and semantics. The 
default is /NOSTANDARD. Compilation time may increase slightly when 
/STANDARD=ANSI is specified. 


e If /STANDARD is specified without a value, /STANDARD=ANSI is assumed 


/TERMINAL[=[NO]SOURCE] 

Encompasses the functionality of VAX C’s /SHOW=TERMINAL qualifier and 
embodies additional functionality as well. If /NOTERMINAL is specified, only the 
summary message is displayed on the user terminal or batch log, as appropriate 
(this is the same as /SHOW=NOTERMINAL under VAX C),. 


If /TERMINAL or /TERMINAL=NOSOURCE is specified, compiler messages are 
displayed on the user terminal or batch log, as appropriate, but associated user 
source text is not displayed (this is the same as /SHOW=TERMINAL under VAX 
C). 


If /TERMINAL=SOURCE is specified, compiler messages and associated user 
source text (without macro expansion) are displayed on the user terminal or 
batch log, as appropriate (this functionality is not available under VAX C). 


The default is /TERMINAL=NOSOURCE, or as established during installation of 
PDP-11 C. 


/TITLE=(identifier) 

/NOTITLE 

Controls the compiler produced output list header for the program file. This 
qualifier if asserted must be supplied with a string value. The identifier is the 
list title name for a given compilation unit. 


The default is /NOTITLE. 


/UNDEFINE=(identifier,...]) 

/NOUNDEFINE 

Performs the same function as the #undef preprocessor directive—it cancels a 
macro definition. It is useful for undefining the predefined PDP11 C preprocessor 
constants. For example, if you use a preprocessor constant (such as pdpc, PDPC, 
PDP11C, or vms) to conditionally compile segments of PDP11 C specific code, you 
can undefine constants to see how the portable sections of your program execute. 
For example; /UNDEFINE="pdpc". 


When both /DEFINE and /UNDEFINE are present on the CC command line, 
/DEFINE is evaluated before /UNDEFINE. The default is /NOUNDEFINE. 


/WARNINGS 

/[LNO]WARNINGS[=(option.,...)] 

Controls whether the compiler prints warning diagnostic messages, informational 
diagnostic messages, neither, or both. The options are NOINFORMATIONALS 
and NOWARNINGS. 


The /WARNINGS qualifier alone forces the compiler to print both informationals 
and warnings (the same as if no qualifier were used on the command line). The 
/NOWARNINGS qualifier forces the compiler to suppress both informationals and 
warnings. 
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The /WARNINGS=NOINFORMATIONALS qualifier forces the compiler to 
suppress the informationals. The /WARNINGS=NOWARNINGS qualifier forces 
the compiler to suppress warnings. The default is /(WARNINGS. 


/[LNOJ]WORK_FILE_SIZE=integer_number 
The integer_number is a integer value between 1 and 65535 representing the 
number of 512-byte disk blocks to allocate for the work file. 


If /WORK_FILE_SIZE is not specified, a default work file size that is specified 
when PDP-11 C is installed is used. If the specified value exceeds the maximum 
determined by the system manager when PDP-11 C is installed, the maximum 
value is used instead. The work file size determines PDP-11 C’s capacity for 
processing source input. Note that the (MEMORY qualifier affects PDP-11 C’s 
performance, not capacity. 


The work file is placed at a location that is specified when PDP-11 C is installed. 
PDP-11 C first attempts to open the work file contiguously. If insufficient 
contiguous disk storage is available, PDP-11 C attempts to open the work file 
noncontiguously. If insufficient noncontiguous disk storage is available, PDP-11 C 
issues a diagnostic and aborts. PDP-11 C does not extend the work file: if work 
file storage is exausted during compilation, a diagnostic is issued and PDP-11 C 
aborts. 


NOTE 


If this qualifier is used it MUST be specified with the first compilation 
unit. 
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8.6 COBOL 


The COBOL command compiles a COBOL-81 program. (You can compile only one 
source file at a time with COBOL-81.) 


Format 
COBOL [source_file] 
Command Qualifiers Defaults 
/[NOJANSL_ FORMAT /NOANSL FORMAT 
/C81 /C81 
/[NO]CHECK /ICHECK 
/CHECK[=[NO]BOUNDS] none 
/CHECK[=[NO]PERFORM] none 


/CODE=[NOJCIS 
/[NO]CROSS_ REFERENCE 


See discussion 
/NOCROSS_REFERENCE 


/[NO]DEBUG /NODEBUG 
/[NO]DIAGNOSTICS[=diagfile] /NODIAGNOSTICS 
/[NO]LIST[=listfile] /NOLIST 
/[NO]MAP /NOMAP 
/NAMES=aa /NAMES=SC 
/[NOJOBJECT[=objfile] /OBJECT[=objfile] 
/[NOJOPTIMIZE /NOOPTIMIZE 
/[NO]JSHOW /NOSHOW 
/SHOW[=[NO]MAP] See discussion 
/STANDARD[=option] /NOSTANDARD 
/[[NO]|SUBPROGRAM /NOSUBPROGRAM 
/TEMPORARY=device /TEMP=SY: 
/[[NO]JTRUNCATE /NOTRUNCATE 
/[NOJWARNINGS /WARNINGS 


/WARNINGS[=[NO]INFORMATIONAL] 


Prompts 
File: source_file 


Command Parameters 
source _file 


/WARNINGS=INFORMATIONAL 


Specifies a COBOL program to be compiled. You must specify a source file name. 
If you do not include a file type, the compiler uses the default type of .CBL. 


No wildcards are allowed for the source file. 
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Command Qualifiers 


/ANSL FORMAT 

/NOANSL FORMAT 

Indicates whether the source program is in ANSI COBOL format or in Digital’s 
terminal format. 


An ANSI COBOL source file has 80-character records with Area A beginning in 
column position 8. 


The recommended default is for the COBOL command to assume that the input 
records are in terminal format. (Area A begins in column position 1 and the 
lines do not have line numbers.) However, your system manager can change the 
default at system installation. 


/C81 | 
Specifies the COBOL-81 compiler. This is the default. 


(CHECK 

/NOCHECK 

/CHECK[=[NO]BOUNDS] 

/CHECK[=[NO]PERFORM] 

Controls whether the compiler produces extra code to check for program correct- 
ness at run time. The /CHECK qualifier verifies subscripts, indexes, and perform 
statement ranges. The /CHECK qualifier is the recommended default and causes 
COBOL-81 to check each subscript and table at run time against the ranges 
defined by its data-name’s OCCURS clause. (Your system manager can change 
this default at system installation.) The /CHECK qualifier also causes COBOL-81 
to determine if your program’s PERFORM ranges are nested properly (if nested 
at all). If COBOL-81 detects improper nesting during execution, it issues an error 
message to that effect. 


The /NOCHECK qualifier suppresses all checking, which can save execution time 
and decrease task image size. If you use /NOCHECK to suppress error checking, 
an out-of-range subscript or index does not generate an error message. The 
/NOCHECK qualifier also stops the compiler from generating code needed for 
checking PERFORM statement ranges. If you use /NOCHECK and the program’s 
PERFORM statements are nested incorrectly, the program does not produce valid 
results. 


You can have the compiler generate code to check only subscripts and indexes 
by specifying /CHECK=(BOUNDS, NOPERFORM). Likewise, you can check only 
PERFORM statement ranges by specifying /CHECK=(PERFORM, NOBOUNDS). 


/CODE=CIS 

/CODE=NOCIS 

Controls whether the compiler uses Commercial Instruction Set (CIS) in the 
object code it produces. CIS speeds program execution; however, not all processors 
support CIS. 


If your processor has CIS, the recommended default is /CODE=CIS; however, your 
system manager can change the default at system installation. If your processor 
does not have CIS, the default is /CODE=NOCIS. 


/CROSS_REFERENCE 

/NOCROSS_REFERENCE 

Controls whether the compiler listing includes a cross-reference listing. By 
default, the compiler does not create a cross-reference listing. In addition, you 
receive the error message ?Additional qualifier needed, unless you specify the 
/LIST qualifier. 
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/DEBUG 

/NODEBUG 

Causes the compiler to use the COBOL-81 Symbolic Debugger. (The debugger lets 
you control and monitor your program as it runs by referring to the source version 
rather than the object code produced by the compiler.) The compiler generates 
symbol information in the object module for all data-names and procedure-names. 
This increases the size of the object file, but when you finish debugging and no 
longer need the symbols, you can recompile without using this qualifier. 


The recommended default is /NODEBUG; however, the system manager can 
change the default at system installation. 


If you use the Symbolic Debugger in your program, you must also use the 
LINK/DEBUG command to include the Debugger in your task image. See the 
LINK command for more information. 


/DIAGNOSTICS[=diagfile] 
/NODIAGNOSTICS 
Controls whether the compiler produces an output diagnostic file. 


The diagnostic file is a subset of the list file. It contains only the diagnostics 
issued, along with the line of source code to which each diagnostic applies. 


By default, the COBOL-81 compiler does not create a diagnostics file. If you 
specify /DIAGNOSTICS without a file specification, the compiler creates a 
diagnostic file with the same name as the object file, and in the same directory 
on the same device as the object file, but with a .DIA file type. If you also specify 
/NOOBJECT, then the file has the same name as the source file, and is in your 
directory on SY:. 


/LIST[slistfile] 
/NOLIST 
Controls whether the compiler produces an output listing. 


The COBOL-81 compiler, by default, does not create a listing file. If you specify 
/LIST without a file specification, the compiler creates a listing with the same 
name as the object file, and in the same directory on the same device as the object 
file, but with an .LST file type. If you also specify /NOOBJECT, then the file has 
the same name as the source file, and is in your directory on SY:. 


If you include a file specification, the listing is written to that file or device. The 
default file type is .LST. 


/MAP 

/NOMAP 

The /MAP qualifier is the same as /SHOW=MAP. The /NOMAP qualifier is the 
same as /SHOW=NOMAP. This qualifier exists for compatibility with previous 
releases of RSTS/E. 


/NAMES=aa 

Requests the compiler to generate program section names ending with the 
two-character alphanumeric suffix, aa. If you link several object files into one 
executable file then each object file must have a different suffix for its program 
section names. 


If you do not specify the /NAMES qualifier, RSTS/E uses the default suffix SC. 
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/OBJECT[=obijfile] 

/NOOBJECT 

Controls whether the compiler produces an object file and a skeleton file. These 
files are used as input to the LINK command, which in turn produces an 
executable program. 


By default, (or if you specify /OBJECT without a file specification), the compiler 
produces an object file with the same file name as the input file in your directory 
on the public disk structure, with a file type of .OBJ. The compiler also uses the 
default file type of .OBJ when you include a file name but no file type with the 
/OBJECT qualifier. The skeleton file is in the same directory and has the same 
name as the object file, but has an .SKL file type. 


You cannot use wildcard characters in the file specification. 


/OPTIMIZE 
/NOOPTIMIZE 
Tells the compiler whether to produce optimized code. The default is /OPTIMIZE. 


/SHOW 

/NOSHOW 

/SHOW=MAP 

/SHOW=NOMAP 

Determines whether the compiler produces a Data Division map showing the 
memory addresses for Data Division entries. The /SHOW and /SHOW=MAP 
qualifiers perform the same operations. The /NOSHOW and /SHOW=NOMAP 
qualifiers also produce the same results and are the recommended defaults. 
However, your system manager can change the default at system installation. 


You can use this qualifier only in conjunction with /LIST. 


/STANDARD-=option 

/NOSTANDARD 

STANDARD=85 compiles code according to the ANSI 1985 COBOL standard. 
STANDARD=V2 compiles code according to the syntax rules for COBOL-81 V2.5. 
The default is /NOSTANDARD. 


/SUBPROGRAM 

/NOSUBPROGRAM 

Indicates the compiler is compiling a subprogram. Use this qualifier only if the 

subprogram has not passed parameters from the calling program—that is, if the 
subprogram does not contain the PROCEDURE DIVISION USING header. The 
default is /NOSUBPROGRAM. 


/TEMPORARY=device 

Changes the storage area for temporary work files from SY: (the default) to the 
value you specify for "dev" (device). This qualifier is useful if you are running out 
of space on the system disk, or if you have a faster disk available. Because of the 
way the compiler names its temporary work files, two simultaneous compilations 
of source programs with the same file name, in the same account, (regardless 

of the types used) produces unpredictable results. This problem will not occur, 
however, if you use the /TEMPORARY=dev qualifier to specify a nondefault device 
for those files. 
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/TRUNCATE 

/NOTRUNCATE 

Specifies that the compiler perform decimal truncation on the values of COMP 
data items. 


The recommended default is for COBOL-81 to perform binary truncation rather 
than decimal truncation. (Your system manager can change the default at 
system installation.) With binary truncation, the maximum value a COMP 
item can contain depends on its storage allocation. If you specify /TRUNCATE, 
the maximum value depends on the item’s PICTURE character-string. See the 
COBOL-81 RSTS/E User’s Guide for more information. 


/[LNO]WARNINGS 

/WARNINGS=INFORMATIONAL 

/WARNINGS[=NOINFORMATIONAL] 

The /NOWARNINGS and /WARNINGS=NOINFORMATIONAL qualifiers stop the 
compiler from issuing informational diagnostics during the compilation. If you 
specify either of these qualifiers, only warning and fatal diagnostics will appear 
in the list file, diagnostics file, and diagnostic summary. 


The /WARNINGS and /WARNINGS=INFORMATIONAL qualifiers, the recom- 
mended defaults, specify that the compiler issue informational diagnostics during 
the compilation. 
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8.7 DIBOL 


Format 


The DIBOL command compiles a DIBOL-11 program. You can include up to six 
source file specifications to be compiled into a single object file with the DIBOL 
compiler. The default file type is .DBL. 


DIBOL  filespecy,...] 


File Qualifiers Defaults 
/[NO]DEBUG /NODEBUG 
/[NO]LIST[=listfile] /NOLIST 
/[NOJOBJECT[=objfile] /OBJECT 
/[NOJOPTIMIZE /NOOPTIMIZE 
/[NOJSTANDARD /NOSTANDARD 
/STANDARD=ANSI /NOSTANDARD 
/STANDARD=D83 /NOSTANDARD 
/[NO]WARNINGS /WARNINGS 


Command Parameters 


filespec[,...] 

Specifies a DIBOL program to be compiled. You can include up to six source file 
specifications to be compiled into a single object file. If you do not include a file 
type, the compiler uses the default type of .DBL. 


No wildcards are allowed for the source file. 


File Qualifiers 


/DEBUG 
/NODEBUG 
Controls whether the compiler uses the DIBOL Debugging Technique (DDT). 


If you specify /DEBUG, you must also use the /DEBUG qualifier when you or 
more separately compiled subroutines, and you want to use the debugging tool 
on the entire program, you must compile each subroutine with the /DEBUG 
qualifier. You can mix sections of your program that have been compiled with 
/DEBUG with sections that have not been compiled with /DEBUG. However, you 
can use debugging tools only in the sections compiled with /DEBUG. 


/LIST[=listfile] 
/NOLIST 
Controls whether or not the DIBOL compiler produces an output listing. 


By default, the compiler does not create a listing file. If you specify /LIST without 
a file specification, then the compiler gives a listing file the same file name as the 
object file (or, if you specify /NOOBJECT, as the first input source file). The file is 
placed in the same directory on the same device as the object file, but with a .LST 
file type. 


You cannot use wildcard characters in the file specification. 
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/OBJECT[=objfile] 
/NOOBJECT 
Controls whether the compiler produces an output object file. 


By default, or if you specify /OBJECT without a file specification, the compiler 
produces an object module that has the same file name as the first input source 
file, and places it in your directory on the public disk structure with a file type of 
OBJ. 


You cannot use wildcard characters in the file specification. 


/OPTIMIZE 
/NOOPTIMIZE 
Produces optimized code. The default is /NOOPTIMIZE. 


/STANDARD 

/STANDARD=ANSI 

/STANDARD=D83 

Specifies the syntax that the DIBOL compiler will accept. Specifying /STANDARD 
or /STANDARD=ANSI tells the compiler to accept ANSI DIBOL SYNTAX. 
Specifying /STANDARD=D83 tells the compiler to accept DIBOL-83 syntax. The 
default is /NOSTANDARD. 


/WARNINGS 

/NOWARNINGS 

Controls whether the compiler produces diagnostic messages for warning condi- 
tions. 


Use /NOWARNINGS to override the compiler default. (The default is to issue 
warning diagnostic messages.) 
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8.8 FORTRAN 


The FORTRAN command compiles up to six FORTRAN source files into a single 
object file. 


There are two FORTRAN compilers available on RSTS/E: 


Command Invokes 
FORTRAN/F77 FORTRAN-77 
FORTRAN/FOR FORTRAN-IV 
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8.8.1 FORTRAN/F77 


The FORTRAN/F77 command invokes the FORTRAN-77 compiler. 


Format 
FORTRAN/F77 file-specy,...] 
Command Qualifiers Defaults 
/[NO]JCHECK /ICHECK 
/CONTINUATIONS=n /CONTINUATIONS=19 
/[NO]D_LINES /NOD_LINES 
/[NO]DEBUG /NODEBUG 
/[NO]I4 /NOI4 
/[NOJIDENTIFICATION /NOIDENTIFICATION 
/[NO]LIST[=listfile] /NOLIST 
/[NOJMACHINE_CODE /NOMACHINE_CODE 
/[NOJOBJECT[=objfile] /OBJECT 
[NOJOPTIMIZE /OPTIMIZE 
/STANDARDJ[=ALL] /NOSTANDARD 
/STANDARD[=SOURCE] /NOSTANDARD 
/STANDARD[=SYNTAX] /NOSTANDARD 
/NOSTANDARD /NOSTANDARD 
/[NOJ]WARNINGS /WARNINGS 


/WORK_FILES=n /WORK_FILES=2 


Prompts 
File: file-specy,...] 


Command Parameters 

file-spec[,...] 

Specifies one or more FORTRAN source programs to be compiled. If you do not 
specify a file type, the compiler uses the default file type of .FTN. 


You can specify more than one input file. The files are compiled as a single input 
file. The result is one object module and, if /LIST is specified, one listing. 


You cannot use wildcard characters in the file specification. 


Command Qualifiers 


/CHECK 

/NOCHECK 

Controls whether the compiler produces extra code that checks for program cor- 
rectness at run time. The /CHECK qualifier (the default) causes the production 
of code to check that all array references are to addresses within the address 
boundaries specified in the array declaration. 


/CONTINUATIONS=n 
Specifies the maximum number of continuation lines to be permitted. 
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The number of lines, n, is a decimal number from 0 through 99. By default, the 
compiler accepts a maximum of 19 continuation lines. 


/DEBUG 

/NODEBUG 

Specifies that the compiler is to provide symbol table information for use by 
the FORTRAN-77 symbolic debugger. When you use the /DEBUG qualifier you 
should also use the /NOOPTIMIZE qualifier. 


The default is /NODEBUG. 


/D_LINES 

/NOD_LINES 

Indicates whether the compiler reads and compiles debugging lines, which have 
a D in column 1 of the source program. (Debugging lines check that the program 
is working; they are not needed after the program is debugged.) If you specify 
/D_LINES, lines that have a D in column 1 are compiled. 


The default is /NO_DLINES, which means the compiler assumes that lines 
beginning with a D are comments and does not compile them. 


4 

/NOI4 

Controls how the compiler interprets INTEGER and LOGICAL declarations that 
do not specify a length. 


If you specify /I14, the compiler allocates a default length of two words (four bytes) 
for integer and logical variables. 


If you specify /NOI4, the compiler interprets the declarations as INTEGER*2 and 
LOGICAL*2, respectively. /NOI4 is the default. 


/IDENTIFICATION 

/NOIDENTIFICATION 

Controls whether the FORTRAN-77 compiler identification and version numbers 
are typed on your terminal. The default is /NOIDENTIFICATION. 


/LIST[=listfile] 
/NOLIST 
Controls whether a listing file is produced. 


By default, the compiler does not create a listing file. If you specify /LIST without 
a file specification, then the compiler gives a listing file the same file name as the 
object file, (or, if you specify /NOOBJECT, as the first input source file) and in the 
same directory on the same device as the object file, but with an .LST file type. 


If you give a file specification, the listing is written to that file. The default file 
type is .LST. 


You cannot use wildcard characters in the file specification. 


/MACHINE_CODE 

/NOMACHINE_CODE 

Controls whether the listing produced by the compiler includes the machine 
language code that the compiler generated. 


The default is /NOMACHINE_CODE, which omits machine language code in the 
listing. The /(MACHINE_CODE qualifier is invalid unless you also specify the 
/LIST qualifier. 
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/OBJECT[=objfile] 
/NOOBJECT 
Controls whether the compiler produces an output object file. 


By default (or if you specify /OBJECT without a file specification). the compiler 
produces an object module that has the same file name as the first input source 
file, in your directory on the public disk structure. The default file type .OBJ. 


You cannot use wildcard characters in the file specification. 


/OPTIMIZE 
/NOOPTIMIZE 
Tells the compiler whether to produce optimized code. The default is /OPTIMIZE. 


Use the /NOOPTIMIZE qualifier during a debugging session to make sure that 
the debugger has sufficient information to help you locate errors in your source 
program. 


/STANDARD[=ALL] 

/STANDARD[=SOURCE] 

/STANDARD[=SYNTAX] 

/NOSTANDARD 

Checks your source code for extensions to ANSI standard FORTRAN at the 
full-language level, where: 


ALL Checks for all extensions 

SOURCE Checks for lowercase letters and tab characters 
SYNTAX Checks for syntax extensions 

The default is /NOSTANDARD. 

/WARNINGS 


/NOWARNINGS 
Controls whether the compiler produces diagnostic messages for warning 
conditions. 


Use /NOWARNINGS to override the compiler default, which is to issue warning 
diagnostic messages. 


/WORK_FILES=n 
Determines the number of temporary disk work files that should be used during 
compilation. You can use from one to three files; the default value for n is 2. 


If you increase the number of files, the size of the largest program to be compiled 
can be increased, but you may decrease compilation speed. 
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8.8.2 FORTRAN/FOR 


Format 


The FORTRAN/FOR command invokes the FORTRAN-IV compiler. 


FORTRAN/FOR _filespecf,...] 


Qualifiers Defaults 
/CODE=EAE See discussion 
/CODE=EIS See discussion 
/CODE=FIS See discussion 
/CODE=THR See discussion 
/[NO]D_LINES /NOD_LINES 
/[NOJEXTEND_SOURCE /NOEXTEND_SOURCE 
/[NO]I4 /NOI4 
/[NO]LINENUMBERS /LINENUMBERS 
/[NO]LIST[=listfile] /NOLIST 
/[NO]JMACHINE_CODE /NOMACHINE_CODE 
/[NOJOBJECT [=objfile] /OBJECT 
/[NOJOPTIMIZE /OPTIMIZE 
/[NO]WARNINGS /WARNINGS 


Command Parameters 


filespec [,...] 
Specifies one or more source files to be compiled into a single object file. The 
default file type is .FOR. 


Command Qualifiers 


/CODE=EAE 

/CODE=EIS 

/CODE=FIS 

/CODE=THR 

The /CODE qualifiers select the type of object code to be generated. 


The compiler produces distinctly different types of object programs by generating 
either threaded code or inline code. The default is determined by the system 
manager at system installation time. 


The valid values are: 


EAE — Selects EAE hardware 

EIS — Selects EIS hardware 

FIS — Selects EIS and FIS hardware 
THR — Selects threaded code 
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When the compiler produces inline code ((CODE= followed by EAB, EIS, or FIS) 
the object program executes at greater speed and generally uses less physical 
memory. Inline code achieves this optimization, in part, by omitting instructions 
to detect or report certain error conditions. However, you can generate code for 
error checking by including the /CODE=THR option in the compiler command 
line. 


When the compiler generates threaded code (through the /CODE=THR option), 
the object program produced uses a symbolic library routine to perform each 
operation required for program execution. The executable program consists of 

a "threaded" list of the addresses of library routines and appropriate operand 
addresses. This type of code generation produces an object module that operates 
independently of hardware arithmetic configuration. You can combine it with any 
of the FORTRAN-IV OTS libraries to produce a valid executable program for each 
type of arithmetic hardware without any need for recompilation. 


/D_LINES 

/NOD_LINES 

Indicates whether the compiler reads and compiles debugging lines. (Debugging 
lines have a D in column 1 of the source program.) If you specify /D_LINES, lines 
that have a D in column 1 are compiled. 


The default is /NOD_LINES, which means the compiler assumes that lines 
beginning with a D are comments and does not compile them. 


/EXTEND_SOURCE 

/[NOJEXTEND_SOURCE 

Indicates whether to allow source lines to contain significant characters in 
columns 73 through 80. 


The default is /NOEXTEND_SOURCE. 


/\4 

/NOI4 

Controls how the compiler interprets INTEGER and LOGICAL declarations that 
do not specify a length. 


If you specify /I4, the compiler allocates a default length of two words (four bytes) 
for integer and logical variables. 


By default (or if you specify /NOI4), the compiler interprets these as INTEGER*2 
and LOGICAL*2, respectively. 


/LINENUMBERS 

/NOLINENUMBERS 

The /LINENUMBERS qualifier indicates that internal sequence numbers are to 
be included in the executable program for routine diagnostics. 


The /NOLINENUMBERS qualifier suppresses generation of internal sequence 
numbers. 


/LIST=[listfile] 
/NOLIST 
Controls whether a listing file is produced. 


The compiler does not create a listing file by default. If you specify /LIST without 
a file specification, then the compiler gives a listing file the same file name as the 
object file. (If you specify /NOOBJECT, then the compiler gives the name of the 
first input source file.) The file also is in the same directory on the same device 
as the object file, but with an .LST file type. 
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If you give a file specification, the default file type is .LST. You cannot use 
wildcard characters in the file specification. 


/MACHINE_CODE 

/NOMACHINE_ CODE 

Controls whether the listing produced by the compiler includes the machine 
language code that the compiler generated. 


The default is /NOMACHINE_CODE, which omits machine language code in the 
listing. The /(MACHINE_CODE qualifier is invalid if /LIST is not specified. 


/OBJECT[=objfile] 
/NOOBJECT 
Controls whether the compiler produces an output object file. 


By default, or if you specify /OBJECT without a file specification, the compiler 
produces an object module that has the same file name as the first input source 
file, in your directory on the public disk structure, with a default file type of .OBJ. 
If you give a file specification, the default file type is .OBJ. You cannot use 
wildcard characters in the file specification. 


/OPTIMIZE 
/NOOPTIMIZE 
Tells the compiler whether to produce optimized code. The default is /OPTIMIZE. 


Use the /NOOPTIMIZE qualifier during a debugging session to make sure that 
the debugger has sufficient information to help you locate errors in your source 
program. 


/WARNINGS 

/NOWARNINGS 

Controls whether the compiler produces diagnostic messages for warning condi- 
tions. 


Use /NOWARNINGS to override the compiler default. (The default is to issue 
warning diagnostic messages.) 
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8.9 MACRO 


The MACRO command invokes a MACRO-11 assembler. You can include up to 
six file specifications with the MACRO command. 


On RSTS/E you can use either MACRO/RT11 or MACRO/RSX11. The default is 
MACRO/RSX11, unless your system manager has changed it. The default file 
type is .MAC with one exception: .MLB is the default file type if you use the 
RSX-based assembler with the /LIBRARY qualifier. 


Format 
MACRO/RT11_ filespecy....] 
OR 
MACRO/RSX11_ filespecy,...] 


Command Qualifiers Defaults 
/[NO]LIST[=listfile] /LIST[=listfile] 
/[NOJOBJECT[=objfile] /OBJECT[=obifile] 


File Qualifiers 
/LIBRARY 


Command Parameters 


filespec[,...] 

Specifies one or more source files to be compiled into a single object file. The 
default file type is MAC with one exception: .MLB is the default file type if you 
use the RSX-based assembler with the /LIBRARY qualifier. 


Command Qualifiers 


/LIST[=listfile] 

/NOLIST 

Controls whether a listing file is produced. Unlike the other languages on 
RSTS/E, MACRO produces a listing file by default. (In other words, the /LIST 
qualifier is assumed.) The assembler gives a listing file the same file name as the 
object file and puts it in the same directory on the same device as the object file. 
If you specify /NOOBJECT, then it assumes the name of the first input source 
file, and is placed in your directory on the public structure. The default file type 
is .LST. 


You cannot use wildcard characters in the file specification. 


/OBJECT[=objfile] 
/NOOBJECT 
Controls whether the assembler produces an output object module. 


By default (or if you specify /OBJECT without a file specification), the assembler 
produces an object module that has the same file name as the first input source 
file, on your directory on the public structure. The default file type is .OBJ. 
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You cannot use wildcard characters in the file specification. 


File Qualifiers 


/LIBRARY 
Indicates that the file is a macro library. 


When a macro call is found in the source program, MACRO-11 searches the user 
macro library for the named macro definitions. If necessary, MACRO-11 then 
continues the search with the system macro library. 
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8.10 LINK 


The LINK command combines one or more of your compiled or assembled object 
files, including routines from appropriate libraries, into a single executable file. 


NOTE 


This section describes the DCL LINK command and its qualifiers. 
See the RSTS/E Task Builder Reference Manual or the RSTS/E 
RT11 Utilities Manual for a complete description of linking concepts, 


overlays, and libraries. 


Format for Simple (Non-Overlaid) Link 


Format for 


LINK _ file-specf,...] 


Overlaid Link 
LINK /STRUCTURE 


LINK prompts for overlay structure 


Command Qualifiers 
/CODE=[NO]DATA_SPACE 
/SORT_AND_MERGE=[NO]RESIDENT 


Language Qualifier 
/BASIC or /BP2 


Defaults 


/CODE=NODATA_SPACE 


none 


See discussion 


[CC none 

/COBOL or /C81 none 

/DIBOL none 
/[NO]DMS /NODMS 

/F77 none 

/FOR none 

/RSX11 See discussion 
/RT11 none 

(STACK See discussion 


Debugging Qualifier 
/[NO]DEBUG 


Description Qualifier 
/DESCRIPTION 


Forms Management System Qualifier 
/[NO]FMS 
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/NODEBUG 


See discussion 


none 


Library Qualifiers 


/FMS[=[NO]RESIDENT] none 
/OTS=[NO]RESIDENT none 
/[NO]RMS none 
/RMS=[NO]RESIDENT 

=SUPERVISOR 

=USER 
Output File Qualifiers 
/[NOJEXECUTABLE[=filespec] /EXECUTABLE 
/[NO]MAP[=filespec] /NOMAP 
Overlay Qualifier Defaults 
/STRUCTURE (no overlay structure) 


Prompt (No Overlays) 
Files: file-spect[,file-spec2, ... ] 


Prompt (Overlays requested with /STRUCTURE qualifier) 


= ROOT files: file-spect[,file-spec2, ... ] 
Root COMMON areas: [common-area][, ... ] 
Overlay: [file-spec[, ... ][+]] 


(more prompts for overlays) 


Two linker programs are available on RSTS/E: 

¢ The RSX-based linker (the Task Builder) 

e The RT11-based linker (LINK.SAV) 

The LINK command invokes one or the other, depending on your source 


language. (You indicate the source language by including a language qualifier. ) 
BASIC-PLUS-2 is the default. 
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Table 8—3 shows the language qualifiers and whether the RSX-11-based or 
RT11-based linker is run in each case. 


Table 8-3: Language Qualifier, Source Language, and Linker Relationship 


Qualifier Source Language Linker 

/BP2 BASIC-PLUS-2 RSX-11-based 
/BASIC 

/CC C PDP11-C-based 
/COBOL COBOL-81 RSX-11-based 
/C81 

/DIBOL DIBOL RSX-11-based 
[E77 FORTRAN-77 RSX-11-based 
/FOR FORTRAN-IV RT11-based 
/RSX11 MACRO Assembler RSX-11-based 
/RT11 MACRO Assembler RT11-based 


Command Parameters 


Input file list 

The LINK command creates an executable file from one or more of your compiled 
or assembled object files. You specify the input files, that is, the object files, in 
one of two places in the LINK command: either beginning on the same line as 
the LINK command or in response to the prompt, depending on whether you use 
the /STRUCTURE qualifier to request overlays. 


In any case, the standard RSTS/E defaults for file specifications apply. The 
default device is the public structure (SY:); the device must be disk. The default 
file type for input files (your object files to be linked) is .OBJ. Note that for 
COBOL programs, the LINK command expects to find a skeleton file (type .SKL) 
on the same device and account, with the same file name, as each .OBJ file listed. 
(A COBOL compile automatically produces .SKL and .OBJ files.) 


Simple (Nonoverlaid) Linking 

For a simple (nonoverlaid) link, specify the object files beginning on the same line 
as the LINK command. If you have many files, you can continue a line by typing 
a hyphen (-) at the end of the line. 


The LINK command translates the command you specify into a command line 

to another program. The translated command cannot exceed 127 characters (80 
characters for a COBOL program). If the continued command line is too long, 
you get the error message ?Command too long. If you need to link more files, you 
must run the Task Builder or the LINK linker directly (see the RSTS/E Task 
Builder Reference Manual or the RSTS/E RT11 Utilities Manual), 


The files you name are linked, together with routines from appropriate libraries, 
in the order you specify. That is, the first file you name occupies the lowest range 
of addresses in the program, the second file you name is linked to occupy a range 
of addresses immediately following the first, and so forth. 


Command Qualifiers 


/CODE=[NO]DATA_SPACE 
This qualifier indicates the program uses seperate I & D space. 
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/SORT_AND_MERGE=[NO]RESIDENT 
This qualifier invokes the Sort/Merge utility and specifies the correct library 
(resident vs. nonresident). 


Language Qualifiers 


/BASIC 

/BP2 

Indicates that the object files listed in the command are BASIC-PLUS-2 object 

files. Unless your system manager selects another default for your site, /BP2 is 
the default if you do not specify any language qualifier. (/BASIC and /BP2 are 

equivalent qualifiers. ) 


This qualifier provides an easy way to link BASIC-PLUS-2 programs. However, 
Digital recommends that you use the /DESCRIPTION qualifier instead of /BP2 
to link nonoverlaid BASIC-PLUS-2 programs. /DESCRIPTION allows you to 
use the defaults you specify at installation and with the BASIC-PLUS-2 BUILD 
command. You cannot use these defaults when you use the /BASIC and /BP2 
qualifiers with the LINK command. Instead, you must specify what you would 
like to use each time you type the LINK command. 


A BASIC-PLUS-2 program requires the resident library RMS (Record 
Management Services) if any OPEN statements include the ORGANIZATION 
clause or if the FMS (Forms Management System) qualifier is specified. See the 
PDP-11 BASIC-PLUS-2 Language Reference Manual for more information. 


(CC 
Indicates that the files listed in the command are PDP11-C object files. 


/COBOL 

/C81 

Indicates that the skeleton and object files listed in the command are COBOL-81 
files. (COBOL and /C81 are equivalent qualifiers.) 


The LINK command includes RMS if the COBOL program requires it. 


/DIBOL 
Indicates that the object files listed in the command are DIBOL object files. 


/DMS 

/NODMS 

This qualifier invokes the DMS variant of the Dibol compiler. The default is 
/NODMS. 


/FOR 
Indicates that the files listed in the command are FORTRAN-IV object files. 


/F77 
Indicates that the files listed in the command are FORTRAN-77 object files. 


With FORTRAN-77, you can use I/O channels 1-14 in your program. The 
maximum record size for I/O is 512 bytes. See the PDP-11 FORTRAN User’s 
Guide if you need a larger record size. 


If your program stores a format specification in an array, the size of the specifica- 
tion is limited by the size of an internal buffer, which is 64 bytes. See the PDP-11 
FORTRAN-77 User’s Guide if your program requires more space. 


The LINK command always includes RMS with this qualifier. You cannot specify 
/OTS=RESIDENT with this qualifier. FORTRAN-77 does not have an Object 
Time System (OTS) resident library. 
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/RSX11 
Indicates that the RSX-11-based assembler (using the MACRO/RSX11 command) 
on RSTS/E systems (MAC.TSK) produced the object files listed in the command. 


The LINK command includes RMS only if you specify the /RMS qualifier. The 
default for MACRO programs is /NORMS. 


/RT11 
Indicates that the RT11-based assembler (using the MACRO/RT11 command) on 
RSTS/E systems (MACRO.SAV) produced the object files listed in the command. 


The LINK command cannot use RMS with this qualifier. 


(STACK 

Specifies the size of the executable program’s stack space, in words. The /STACK 
qualifier corresponds to the STACK=n option in the Task Builder Reference 
Manual. See the RSTS/E Task Builder Reference Manual for further details. 


Forms Management System Qualifier 


/FMS 

/NOFMS 

Indicates that you used the capabilities of the Digital Forms Management System 
(FMS-11) in your program. You can use this qualifier in conjunction with any of 
the RSX-based language qualifiers. You cannot use it with the /FOR or /RT11 
qualifiers. 


/FMS=RESIDENT 

/FMS=NORESIDENT 

Specifies the FMS resident libraries FDVRDB and FDVRES. FDVRDB is the 
FMS resident library that uses debug mode. FDVRES is the resident library 
without debug mode. 


Your system manager can decide to let these libraries belong to a cluster. Cluster 
libraries are useful if you need to use more than one resident library. When they 
are clustered, resident libraries share the same virtual address space in your 
program. See the RSTS/E Task Builder Reference Manual for more information 
on cluster libraries. 


Without cluster libraries, FMS uses 4K words of virtual address space in your 
program. 


With cluster libraries, the LINK command clusters the FMS resident libraries 
with all resident libraries being used. However, the LINK command will not use 
cluster libraries with the /DIBOL qualifier. 


/FMS=NORESIDENT specifies FMS without a resident library. 


Debugging Qualifier 


/DEBUG 

/[NO]DEBUG 

Invokes the appropriate debugging tool for a program that is written in COBOL- 
81, DIBOL, or RSX-11-based MACRO, and/or uses FMS. The debuggers invoked 
with each qualifier follow. The default for each language is /NODEBUG. 


Note that when you use the /DEBUG qualifier with either /C81 or /DIBOL, 

you must also use the /DEBUG qualifier when you compile the program. If 
your program consists of a main program and one or more separately compiled 
subroutines, and you want to use the debugging tool on the entire program, you 
must compile each subroutine with the /DEBUG qualifier. You can mix sections 
of your program that have been compiled using /DEBUG with sections that have 
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not been compiled using /DEBUG. However, the debugging tools will be used only 
in the sections compiled with /DEBUG. 


For a COBOL-81 program, /DEBUG invokes the COBOL-81 Symbolic Debugger. 
See the COBOL-81 RSTS/E User’s Guide for information on the debugging 
techniques used. 


For a DIBOL program, /DEBUG invokes the DIBOL Debugging Technique 
(DDT). See the CT'S-500 DIBOL User’s Guide for information on the debugging 
techniques used. 


If you are using FMS, /DEBUG invokes the debug mode of FMS in addition to 
the other debugging tool. The debug mode of FMS is not available with COBOL- 
81. See the FMS-11/RSTS Reference Software Manual for information on the 
debugging techniques used. 


For an RSX-11-based MACRO program, /DEBUG invokes the Octal Debugging 
Tool (ODT). See the JAS /RSX-11 ODT Reference Manual for information on the 
debugging techniques used. 


For a FORTRAN or RT11-based MACRO program, /DEBUG has no meaning. 
If you use /DEBUG and it cannot be applied, you receive the error message: 


?Additional qualifier needed. 


Description Qualifier 


/DESCRIPTION 

Indicates that the input file describes the process for linking the program, 

including object files to link, the executable and/or map files to create, and 
various other options. A description file is sometimes called a "task builder 
command file." 


If you program in BASIC-PLUS-2, you can specify (DESCRIPTION if you want 
to use CMD and ODL Task Builder command files created by the BASIC-PLUS-2 
BUILD command. Although /DESCRIPTION and /BP2 can perform the same 
functions, unlike /BP2, you can tailor /DESCRIPTION to your system, generally 
resulting in a smaller program. 


You cannot use this qualifier with any of the other LINK qualifiers. The default 
file type is .CMD. You can specify only one input file with /DESCRIPTION. 


Two general types of libraries may be available on your system: 
e Disk libraries (nonresident) 


e Resident libraries 


A library is a collection of software modules in a single file. For disk libraries, the 
Task Builder takes a copy of each routine that you reference in your program and 
builds it into your program. 


Your system manager defines libraries as resident (residing in computer memory) 
so that more than one user can share them. Instead of building routines into 
your program (as is done with disk libraries), you share a copy of the library. The 
copy is resident in memory as long as you or someone else requires it. 


Because they are shared, resident libraries occupy less space on the system. Your 
program uses less memory and processor time: therefore; it runs faster. However, 
because it is necessary to dedicate permanent physical memory for resident 
libraries, your system manager might choose not to install them. By default, 

the LINK command uses resident libraries if they are present on your system. 
Otherwise, LINK uses the appropriate disk libraries. 
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Because both resident and disk libraries take memory from your job, their use 
affects the amount of memory that is available for your program to work in. 
There is a 32K-word limit on job space that can not be set to any other value by 
your System Manager if your program does not use I-and-D space. However, if 
your program does use I-and-D space and you are on an J-and-D system, your 
job space can be set between a 32K-word and a 64K-word limit by your System 
Manager. If you are not on an IJ-and-D system and try to use I-and-D space you 
will get an error message. 


The BASIC-PLUS-2, COBOL-81, and RMS resident libraries can be clustered, 
which means they share virtual address space in your program. In general, 24K 
words of address space are available to your program when you use resident 
libraries that are clustered. 


To learn which libraries are available on your system, type SHOW LIBRARIES. 
Note that the defaults are to use the resident libraries on your system. Therefore, 
the following descriptions of the resident libraries are of interest only if you want 
to change the defaults. 


Address Space and Library Qualifiers 


/OTS=RESIDENT 

/OTS=NORESIDENT 

Specifies the resident library for a language Object Time System (OTS). You can 
use /OTS=RESIDENT only with BASIC-PLUS-2, COBOL-81, and DIBOL. 


/OTS=NORESIDENT specifies the disk library for the language you are using. 


/RMS 

/NORMS 

/RMS=RESIDENT 

/RMS=NORESIDENT 

/RMS=SUPERVISOR 

/RMS=USER 

The /RMS qualifier specifies that RMS (Record Management Services) will be 
used and is the default for all RSX-11-based languages except MACRO. The 
default is /RMS. 


The SUPERVISOR or USER arguments use the specified resident library instead 
of the disk library. For more information, see the previous section on Language 
Qualifiers. 


Two qualifiers, /[NOJEXECUTABLE and /,[NOJMAP, control the output files 
produced by the LINK command. 


Output File Qualifiers 


/EXECUTABLE[sfile-spec] 

/NOEXECUTABLE 

Indicates that you want the LINK command to produce an executable file. The 
default is /EXECUTABLE. If you use the /EXECUTABLE qualifier, you can 
specify a name for the executable file. If you omit the file specification, LINK 
produces an executable file on the public disk structure (SY:) in your account with 
a file name the same as the first file name in the input list. The default file type 
is .TSK (for RSX-based languages) or .SAV (for RT11-based languages). 


If you use the /NOEXECUTABLE qualifier, the LINK command does not 
produce an executable file. You must use the /MAP qualifier if you use 
/NOEXECUTABLE. 
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/MAP[=file-spec] 

/NOMAP 

Use the /MAP qualifier to indicate that you want the LINK command to produce 

a memory map file. Use the /NOMAP qualifier, or (since /NOMAP is the default) 

simply omit the qualifier if you do not want a memory map file. You must specify 


/MAP if you use the /NOEXECUTABLE qualifier. 


If you use /MAP, you can also assign a file specification for the memory map file. 
If you omit the file specification, LINK produces map file on the same device, with 
the same account and name as the executable file. The default file type is .MAP. 


For RSX-based languages, specifying the /MAP qualifier produces the Task 
Builder’s memory map file. For RT11-based languages, the /MAP qualifier 
produces the LINK.SAV memory map. 


Overlay Qualifier 


/STRUCTURE 
Indicates that you want to be prompted for an overlay structure (see the following 
sections). 
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8.10.1 


8.10.1.1 


Overlaid Linking 


For overlays, do not specify the object files on the same line as the LINK com- 
mand. Instead, simply specify the (STRUCTURE qualifier (and other qualifiers, if 
you want). The /STRUCTURE qualifier causes LINK to prompt you for an over- 
lay structure, described later in this chapter. Specify the object files in response 
to these prompts. 


The linking process includes routines in the executable file that are obtained from 
appropriate libraries. You can choose the libraries from which these routines are 
called. The choice depends on the qualifiers you use with the LINK command, 
and whether you choose to use the resident libraries installed on your system. 


When You Can Use /STRUCTURE 


If you wrote your program in BASIC-PLUS-2, DIBOL, or FORTRAN-77, you can 
use the /STRUCTURE qualifier with the LINK command to specify an overlay 
structure. The /STRUCTURE qualifier presents a dialogue that makes it easy to 
work with overlays. 


NOTE 


Instead of using LINK and /STRUCTURE, you can specify overlays 
for these languages using the Overlay Description Language (ODL) 
recognized by the Task Builder. The RSTS/E Task Builder Reference 
Manual describes ODL. Using the ODL language is more complex than 
using the /STRUCTURE qualifier with LINK; however, it is also more 
powerful. 


COBOL programmers work with overlays within the language itself, by using the 
segmentation facility of the COBOL compiler. The RSTS/E COBOL User’s Guide 
describes this facility. You do not need to use the /STRUCTURE qualifier if you 
are doing overlays in COBOL; the LINK command processes the skeleton files 
output from the COBOL-81 compiler. 


If you program in FORTRAN-IV or in MACRO under the RT11 run-time system, 
you must run the LINK.SAV program directly to specify an overlay structure. 
The RSTS/E RT11 Utilities Manual describes this program in detail. 


When you use the /STRUCTURE qualifier, you are prompted for an overlay 
structure. 


8.10.1.2 When Must You Use Overlays? 


If your program is too large to fit in the space available, you must specify an 
overlay structure for it. The discussion of the language qualifiers tell how much 
space is available for programs written in the various languages when you use 
the LINK command. 


The easiest way to find out if your program is too large is to try to link it using a 
language qualifier. If you get the error message ?Task has invalid memory limits, 
your program is too large. 


8-38 Program Development 


8.10.1.3 What Are Overlays? 


The best way to explain overlays is by example. Suppose your program consists 
of a main program (called MAIN) and two separately compiled subroutines (called 
SUB1 and SUB2). Suppose further that MAIN calls both SUB1 and SUB2, and 
that neither SUB1 nor SUB2 contain any calls to separately compiled subroutines 
or to MAIN. Figure 8—1 illustrates the call structure. 


Figure 8-1: Outlining the Call Structure 


MAIN 


(CALL SUB1) (CALL SUB2) 


SUB‘ SUB2 


MK-00574-01 


You can specify an overlay structure such that MAIN is loaded when the program 
is first run. When MAIN calls SUB1, the loading code built into MAIN during 
the LINK process loads SUB1 for execution. Then, when control passes back to 
MAIN and it calls SUB2, SUB2 is brought in to memory overlaying SUB1. 
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Figure 8—2 illustrates a simple overlay in memory. Note that SUB1 and SUB2 
do not call or use data from each other. This logical independence is necessary 
for program pieces that overlay each other. In this example, calls or references to 
data that are not currently in memory must be made from the root, which is the 
MAIN program. 


Figure 8-2: A Simple Overlay in Memory 


(UNUSED MEMORY) 
(UNUSED MEMORY) 


ME = eee TIME-Z 


MK-00575-01 


8.10.1.4 Rules for Constructing Overlays 


In general, you must structure an overlay tree so that calls or references to data 
take place between overlay pieces that are on the same path. A path is any route 
from the root of the structure that follows a series of branches to an outermost 
piece of the tree. Calls or references to data cannot take place between pieces 
that are along different paths. 
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Consider the overlay structure shown in Figure 8-3. The structure shows pieces 
that overlay each other as separate branches of a tree. Paths C and D would start 
at the same virtual address, as would E, F, and G. The paths in this structure are 
A-B-C, A-B-D-F, A-B-D-E, and A-B-D-G. Calls may be made between pieces on 
any of these paths. However, F could not call G, E, or C; C could not call D, E, F, 
or G, and so forth. 


Figure 8-3: Separate Paths in An Overlay Structure 


FOUR PATHS: 
A eae a ences 


MK-00578-01 


When you use the /STRUCTURE dialogue to specify an overlay structure, you 
must be careful to specify a structure that does not contain calls or references to 
data that cross paths. 


You must also be careful when you work with common areas in an overlay 
structure. If a FORTRAN program and subprogram both define a common area 
A, for example, where is the space for A to be allocated? 
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Two examples are shown in Figure 8-4. The common block COMA is defined in 
the pieces AZ and A21. The space for COMA is allocated in A2 because that piece 
is closer to the root. The common block COMB, however, is defined in AO and BO. 
These pieces are not on the same path, so the space for COMB is allocated in both 
AO and BO. Note that AO and BO cannot communicate through COMB. When the 
overlay containing BO is loaded, for example, any data stored in COMB by AO is 
lost. 


The /STRUCTURE dialogue that follows allows you to place COMB in the root of 
the overlay structure, where it can be accessed by AO and BO properly. 


Figure 8-4: Allocating Space for Common Areas 


DEF COMB 


eee ep eae | | 
a oc SPACE FOR COMB ALLOCATED 


ee renee IN BOTH AO AND BO BECAUSE 


: 
| THEY ARE ON DIFFERENT PATHS 
A | A2 : 
| 
;| DEF COMA || 
l 
Sgeaeengany EE _— SPACE FOR COMA ALLOCATED 
IN A2 BECAUSE IT IS 
CLOSER TO THE ROOT 
A21 A22 
DEF COMA 


MK-00591-01 
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8.10.1.5 The /STRUCTURE Dialogue 


You can use the (STRUCTURE qualifier with /F77, /BASIC, or /BP2 and the 
/DIBOL qualifier. You cannot use /STRUCTURE with the /FOR, /RT11, /COBOL, 
or /C81 qualifiers. 


When you use /STRUCTURE, the LINK command prompts you for an overlay 
structure, as shown in the following example. The following example shows how 
you would link the overlay structure shown in Figure 8-4: 


$ LINK/F77/STRUCTURE <RET> 
ROOT files: ROOT <RET> 
Root PSECTS: COMB <RET> 
Overlay: AO+ <RET> 
Overlay: Al <RET> 
Overlay: A2+ <RET> 
Overlay: A2 <RET> 
Overlay: A22 <RET> 
Overlay: <RET> 
Overlay: <RET> 
Overlay: BO 
Overlay: <RET> 


ROOT files: Prompt 


The first prompt presented is "ROOT files:". You respond to this prompt by typing 
the object files that are to form the root of the overlay tree. In this case, there is 
only one such file, named ROOT. If you have more than one such file, type them 
all on one line and separate them with commas. If you need to continue, type a 
hyphen (-) at the end of a line. The LINK command then displays the Continue: 
prompt. 


There is a limit on the number of characters you can type for root files; the 
translated command line must be less than or equal to 127 characters. 


Root PSECTS: Prompt 


The next prompt presented is "Root COMMON areas:". If you are a high-level 
language programmer, you will probably be interested in this question only if 
you define a common area in two pieces of your program that overlay each other. 
When you need to place such a common area in the root of the overlay structure, 
where it can be accessed properly as a common area, you specify the name of the 
common area in response to this question. 


If you need to place more than one such common area in the root, you simply type 
the common area names, separated by commas. To continue a line, type a hyphen 
or a comma at the end of the line. If you type a comma, the LINK command 
assumes you have finished one PSECT name and displays the Continue: prompt 
for you to type more. Typing a hyphen lets you continue typing a PSECT name 
you began on the previous line. 


There is no limit to the number of program sections you can place in the root of 
your program. 

Overlay: Prompts 

With further /STRUCTURE prompts, you define the overlay structure beyond the 
root section. You respond to the “Overlay:" prompts with file specifications for 
object files to be linked. You use two symbols, the plus sign (+) and the comma (,) 


to show how the files are to be overlaid. You can also use the exclamation point 
(!) to include comments in the overlay dialogue. 
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The Plus Sign (+) Symbol 


Consider again the following LINK command to overlay the structure shown in. 
Figure 8-4: 


$ LINK/F77/STRUCTURE <RET> 
ROOT files: ROOT <RET> 
Root COMMON areas: COMB <RET> 
Overlay: AO+ <RET> 
Overlay: Al <RET> 
Overlay: A2+ <RET> 
Overlay: A2 <RET> 
Overlay: A22 <RET> 
Overlay: <RET> 
Overlay: <RET> 
Overlay: BO 
Overlay: <RET> 


As shown, you indicate a branch in the overlay structure by ending a line with a 
plus sign following the pieces from which the branch occurs. The next Overlay: 
prompt is indented two places, to show that you are at the next overlay level. For 
example, Al and A2 overlay each other; their addresses begin immediately after 
the address taken by AO. Likewise, A2 and A22 overlay each other after A2. 


Repeat this process to obtain the desired overlay structure. When you want to 
return to the previous level in the overlay structure, press the RETURN key in 
response to an Overlay: prompt. 


Note that you can nest overlays to seven levels. 
The Comma (,) Symbol 


You use the comma (,) operator in an Overlay: prompt between files that are to 
be concatenated in the overlay structure. 


For example, consider the structure in Figure 8-5. 


Figure 8-5: Overlay Structure Using Concatenated Files 


CNTRL 


AQ 


A‘ 


A21 A22 


MK-00589-01 
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8.10.2 The 


This structure is similar to the one shown in Figure 84, except that the files 
B1, B2, B3, B4, and B5 are concatenated to form one overlay. Use commas to 
separate files that are to be concatenated. The following example shows how to 
use LINK with this structure: 


$ LINK/F77/STRUCTURE <RET> 
ROOT files: CNTRL <RET> 
Root COMMON areas: <RET> 
Overlay: AO+ <RET> 
Overlay: Al <RET> 
Overlay: A2+ <RET> 
Overlay: A2 <RET> 
Overlay: A22 <RET> 
Overlay: <RET> 
Overlay: <RET> 
Overlay: B1,B2,B3,B4,B5 
Overlay: <RET> 


If you end a line with a comma, the LINK command assumes that you want to 
continue concatenating files on the same branch. A Continue: prompt at the 
same level displays for you to continue. For example, the following two lines are 
the same as the Overlay: B1,B2,B3,B4,B5 line shown previously: 


Overlay: B1,B2, 
Continue: B3,B4,B5 


Memory Map File 


As noted in the section on output file qualifiers, the /MAP qualifier causes the 
LINK command to produce a memory map file. This file is a detailed listing of 
the virtual addresses that your program occupies. You can use the /MAP qualifier 
with any language qualifier. 


There are two maps available, depending on the language qualifier you use. The 
RSX-based languages produce a memory map that is described in the RSTS/E 
Task Builder Reference Manual. The RT11-based languages produce a memory 
map that is described in the RSTS/E RT11 Utilities Manual. 


You will probably be interested in the memory map only if you are working with 
overlays and want to examine in some detail what the LINK command has done 
for you. 


Example 8—1 shows the first page of a memory map that the following LINK 
command sequence produces. 


$ LINK/STRUCTURE/MAP=TRY2/EXEC=TRY2 <RET> 
ROOT Files: USER <RET> 

Root COMMON areas: <RET> 

Overlay: INTRO <RET> 

Overlay: CRUNCH <RET> 

Overlay: CHATR <RET> 

Overlay: <RET> 
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Example 8-1: Sample From A Memory Map File 


TRY2.TSK Memory allocation map 


22-JUN-90 


TKB 08 .006 
13:42 


PARTITION NAME : GEN 

IDENTIFICATION : 16RE 

TASK UIC [1,196] 

STACK LIMITS: 001000 001777 001000 00512. 
PRG XFR ADDRESS: 021154 

TOTAL ADDRESS WINDOWS: 4. 

TASK EXTENSION : 512. WORDS 

TASK IMAGE SIZE : 6048. WORDS 

TOTAL TASK SIZE : 6560. WORDS 

TASK ADDRESS LIMITS: 000000 027447 


R-W DISK BLK LIMITS: 000002 000036 000035 00029. 


TRYZ.TSK OVERLAY DESCRIPTION: 


BASE TOP LENGTH 

000000 022127 022130 09304 USER 
022130 023707 001560 00880 INTRO 
022130 022577 000450 00296 CRUNCH 
022130 024317 002170 01144 CHATR 
024320 025613 001274 00700 R3PUT 
025614 027447 001634 00924 R3UPDA 


PAGE 1 


Example 8-1 shows that the memory map file is obscure in terms of what you 
specify in the LINK command. However, you can determine some basic facts: 


e The size of the program is listed in the line headed "TOTAL TASK SIZE." In 
this case, the program is 6560 words long. 


e The section headed TRY2.TSK OVERLAY DESCRIPTION shows the overlay 
structure constructed by LINK. The first two columns of information give 
the starting address (BASE) and ending address (TOP) of each major overlay 
piece in the structure. The next two columns (LENGTH) give the length of 
each piece in octal and decimal number of bytes, respectively. 


e The original LINK command dealt with four files: USER, INTRO, CRUNCH, 
and CHATR. You can see the overlay structure specified by the indentation 
in the memory map: INTRO, CRUNCH, and CHATR overlay each other 
following USER. 


e R38PUT and R3UPDA are overlay pieces from the disk library RMSLIB.OLB, 
which the LINK command has placed in two special overlay structures called 
co-trees. The RSTS/E Task Builder Reference Manual describes co-trees. 


8.10.3 The Temporary Files Produced by LINK 


When you use the LINK command with RSX-based languages, the LINK com- 
mand processor creates two files for the Task Builder: a command file and an 
ODL file. These files tell the Task Builder what to do in creating the executable 
file and map file. 


These files are left in your account. The .TMP file type indicates that they are 
temporary files; that is, they are deleted from your account when you logout. 
The command file is the same type of command file you would use with the 
/DESCRIPTION qualifier. (These temporary files are not created if you use the 
/DESCRIPTION qualifier.) 
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8.11 RUN 


Runs an executable file. 


Format 
RUN  file-spec 


Prompts 
Program: file-spec 


Command Parameters 


file-spec 
Specifies an executable file. 


If you do not specify a file type, the RUN command uses any of the following file 
types, which correspond to executable files: 


e .BAC — A BASIC-PLUS compiled program. (See the BASIC command 
description for more information.) 


e .COM — A DCL command file. You may use the @ command on any .COM 
file, but to use the RUN command, the executable bit (64) must be set. 


e SAV — A "save image” file, which runs under the RT11 run-time system. 
(For example, a FORTRAN-IV executable file is a save image file.) Save 
image files are produced by LINK/FOR or by LINK/RT11. 


e .TSK — A "task" file, which runs under the RSX run-time system (or a 
derivative of RSX). See the LINK command description and the RSTS/E Task 
Builder Reference Manual for more information. 


Your installation may have a different set of executable file types, depending on 
the run-time systems your system manager has installed. 


If you omit a file type, the RUN command searches the specified directory for © 
a file having each runnable file type. The order of the search depends on your 
installation. For example, at some installations the RUN command might search 
for a .TSK file first. If that fails, RUN then searches for a .BAC file, then a SAV 
file. However, another installation might search for file types in a different order. 


You cannot use wildcard characters in the file specification, and you must specify 
a file name. 


Examples of using the RUN command are: 
$ RUN SSYSTAT 


This example runs a system program named SYSTAT. The dollar sign ($ in 
$SYSTAT) indicates the directory [1,2], which is the system library. 


S$ RUN BANKER 


This example runs a user program named BANKER in your account on the public 
structure. 
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Appendix A 
DCL Error Messages 


This appendix lists some DCL error messages that you may encounter when 
using RSTS/E. Section A.2 also indicates the probable cause of the error in your 
use of a command or system program. 


If you perform DECnet/E operations, you may receive messages that are 
described in DECnet/E documentation but not in this appendix. In addition, the 
utility programs that support DCL can produce messages not all of which are 


listed here. Those messages are listed in the RSTS/E Utilities Reference Manual. 


A.1 Special Characters Used in Error Messages 


The question mark (?) and percent sign (%) characters preceding a message 
indicate its severity. A single question mark precedes nonfatal error messages, 
which means that the command failed to do what you asked but you can continue. 
For example: 


?Too many parameters 
In this case, the command failed because you included too many parameters. 


A double question mark precedes severe error messages, which means that the 
command failed to do what you asked and you cannot continue. For example: 


??Fatal system I/O failure 


By contrast, the percent sign identifies a warning message, which means that the 
command may not have worked as you intended. For example: 


Logical name has not been assigned 


In this case, the MOUNT command worked but no logical name was assigned to 
the device. 


Informational messages do not have a preceding character; they provide extra 
details about the effects of a command. For example: 


Queue file being reorganized - please wait... 


This message informs you that, as a result of your command, the file is being 
reorganized. 


Angle brackets ( < > ) surrounding text indicate a place holder for what the 
system inserts when an error message occurs. 


Section A.2 lists the DCL error messages that you can get when using RSTS/E 
and the probable cause. 
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A.2 DCL Error Messages 


?Account or device in use 


Explanation: The device cannot be mounted or dismounted because it 
is open or has one or more open files. This error can also occur when a 
user attempts to access a non-shared disk from a job other than the one 
that mounted the disk. 


?Additional argument required 
Explanation: You did not specify enough arguments in the DCL 
function. 

?Additional qualifier required 


Explanation: You did not include a qualifier required in a command. 


?Ambiguous keyword 
Explanation: You abbreviated a keyword too short; DCL cannot 
distinguish it from other keywords. 

?Argument not allowed 


Explanation: You used an argument with a qualifier that does not 
accept one. 


?Argument required 


Explanation: An argument was not supplied with a qualifier which 
required one. For example, /SINCE=, without an argument, would 
generate this error. 


The user did not supply an argument to a DCL function that required 
one. 


??Bad directory for device 


Explanation: The directory of the device referenced is in an unreadable 


format. For example, the tape format differs from the format you 
specified with the MOUNT command. 


?Can’t access terminal <error text> 


Explanation: An error occurred while attempting to access the terminal 
to send the setup file to. 


?Can’t find file or account 


Explanation: Either the account or file does not exist, or you typed a 
file specification incorrectly. 


?Can’t mount a private disk as public 


Explanation: You tried to mount as public (using the MOUNT 
command’s /PUBLIC qualifier) a disk that was initialized as private. 


?Can’t rebuild disk because device is write protected 


Explanation: A privileged user attempted to rebuild a disk (using 
the MOUNT command’s /REBUILD qualifier), and the drive is write 
protected. Therefore, the mount and rebuild operations fail. 
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?Channel already open 


Explanation: The channel specified in the OPEN command already has 
a file open on it. You must either specify a different channel number or 
use the CLOSE command to close the channel first. 


?Channel not open for input 
Explanation: The channel specified by a READ command is either not 
open or open for writing only. 

?Channel not open for output 
Explanation: The channel specified by a WRITE command is either not 
open or open for reading only. 

?Command not found 


Explanation: The requested command is not in the recall buffer. 


?Command not installed 


Explanation: You typed a DCL command that has not been installed 
on your system. The DCL keyboard monitor could not find the utility 
needed to carry out your command. This message can also be displayed 
if you type a remote file specification in a command that allows remote 
file specifications, but your system does not have DECnet/E. 


?Command too long 


Explanation: The length of the command, including continuation 
lines, exceeds the maximum allowed for the command. Or, the length 
of the translated command string exceeds the maximum allowed for the 
command. 


For example, this message occurs with the LINK command in either of 
two cases: 


e The text you typed in response to the $ prompt and the Files: or 
Root files: prompt added up to more than 127 characters after 
translation. 


e With LINK/COBOL, the text was longer than 80 characters after 
translation. 


% Command will proceed as requested 


Explanation: The user’s symbol tables could not be written out to the 
DCL work file, but the command will be processed. The user may be 
over quota. Corrective action should be taken before the user continues 
processing. 


?Comma required 


Explanation: A DCL function required two or more arguments and 
they were not separated by a comma. 


?Conflicting arguments 


Explanation: Two arguments are considered to conflict within a 
qualifier argument list. For example, you cannot specify both /BRIEF 
and /RESET with the SHOW ACCOUNT command. 
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?Conflicting elements 


Explanation: You specified qualifiers or parameters in a command that 
do not agree in type (for example, a print qualifier with a batch server). 


?Conflicts with terminal setting /AUTOBAUD 
Explanation: The terminal is set to /AUTOBAUD on the SET 
TERMINAL/ANSWERBACK command. 

?Conflicts with terminal setting /ANSWERBACK 


Explanation: , The terminal is set /ANSWERBACK on the SET 
TERMINAL/AUTOBAUD command. 


?Conflicts with terminal setting /HOST_SYNC 


Explanation: The terminal is set /HOST_SYNC on the SET 
TERMINAL/RESUME=ANY command. 


?Conflicts with terminal setting /RESUME=ANY 
Explanation: The terminal is set /(RESUME=ANY on the SET 
TERMINAL/HOST_SYNC command. 

?Controller disabled or inoperative 


Explanation: The LAT device is disabled on a STOP/LAT, START/LAT 
or SHOW COUNTERS/DEVICE command. 


?CPU limit exceeds queue’s maximum 


Explanation: You specified a /CPU_LIMIT value in a SUBMIT 
command larger than the maximum allowed for the queue. 


?Data error on device 


Explanation: One or more characters may have been transmitted 
incorrectly due to a parity error, bad punch combination on a card, or 
similar error. 

?Data error or incorrect density 
Explanation: This message occurs for one of the following reasons: 


e You specified the incorrect density. 


e You did not specify a density, but your system’s default density is 
incorrect for the tape. 


e The data on the tape is damaged. 

e The tape drive is faulty. 

To correct the problem, specify the correct density. If that does not solve 
the problem, try mounting the tape on another drive. 


?Default macro for KB<n>: does not exist 


Explanation: The SET TERMINAL/AINQUIRE command could not 
recognize the terminal and there was no default macro specified for 
this keyboard in the default file, TERDFL.SYS. You should supply a 
default macro for the keyboard. Until that is done, the keyboard’s 
characteristics have to be set manually. 
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?Device does not exist 


Explanation: The device name you specified does not exist on your 
system. 


%Device hung or write locked 
%Dismount will proceed as requested 


Explanation: You attempted to dismount a disk that has been 
physically dismounted. However, the logical dismount will succeed. 


?Device hung or write locked 


Explanation: Check the hardware condition of the device requested. 
Possible causes of this error include a line printer out of paper or a disk 
drive being off line. 


%Device in use 


Explanation: You specified /NOSHAREABLE in an INITIALIZE/SERVER 
command; however, the print server’s device is not available or no 

pseudo keyboards are currently available for the batch server. PBS 
allocates the device as soon as it becomes available. 


?Device is not a terminal 


Explanation: A device other than a terminal was specified. Only 
specify keyboards. 


?Device must be disk 


Explanation: You specified a file on a nondisk device, where a disk 
device is required. 


?Device not available 


Explanation: The specified device exists on the system, but an attempt 
to allocate or use it is prohibited for one of the following reasons: 


e The device is currently reserved by another job. 


e The device requires privilege for ownership and you do not have the 
necessary privilege. 


e The device or its controller has been disabled by the system manager. 


e The device is a keyboard line for pseudo keyboard use only. 


?Device not file-structured 


Explanation: An attempt was made to access a device, other than a 
disk drive or magnetic tape drive, as a file-structured device. 


?Device not write protected 


Explanation: You specified the /NOWRITE qualifier when you tried to 
mount a tape, but the device is not write protected. Write protect the 
device by removing the plastic ring from the tape hub. 


?Device offline 


Explanation: You tried to use a tape or disk, but the device is off line. 
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%Device write protected 


Explanation: The tape or disk is protected against write access. 
Therefore, you can only read files on the device, but cannot write 
(perform output) to the device. If you want to write to the device, first 
write enable the device, next dismount the device, and then mount the 
device again. 


?Device write protected 


Explanation: You requested write access to a device that is write 
protected. Write enable the device and then retype the command. 


?Directory does not exist 


Explanation: A file specification indicates a directory that does not 
exist on the particular disk. Or, a wildcard directory specification failed 
to produce a match on the disk specified. This error can occur only with 
disk files. 


??Disk error during swap 


Explanation: A hardware error occurs when your job is swapped 
into or out of memory. The contents of the job area are lost, but the 


job remains logged in to the system and returns to DCL. Report such 


occurrences to the system manager. 


Disk is being rebuilt - wait... 


Explanation: This informational message is displayed when a user 
attempts to rebuild a disk. The disk is logically mounted when the 
rebuilding operation is complete. 


%Disk is restricted and mounted non-shared, read-only 


Explanation: A user specified /NOREBUILD (to suppress rebuilding) 
in the MOUNT command and the disk was dirty. Therefore, the disk 
is mounted non-shared and restricted, and read-only access is granted. 
("Restricted" means that access is allowed only to users with DEVICE 
privilege.) 


?Disk is mounted non-shared 
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Explanation: This message can be displayed for one of two reasons: 


e A user with MOUNT privilege attempted to dismount a private or 
public disk that was mounted as non-shared by specifying /PUBLIC 
in the DISMOUNT command. 


e <A user without MOUNT privilege attempted to dismount a private 
disk that was mounted as non-shared by specifying /PUBLIC in the 
DISMOUNT command. 


Therefore, the dismount fails. In both cases, the requests to mount and 
dismount are from different jobs. 


?Disk is mounted private or non-shared 
Explanation: This message can be displayed for one of two reasons: 


e A user with MOUNT privilege attempted to dismount a private or 
public disk that was mounted as non-shared (by the same job) or 
private by specifying /PUBLIC in the DISMOUNT command. 


e A user without MOUNT privilege attempted to dismount a private 
disk that was mounted as non-shared (by the same job) or private by 
specifying /PUBLIC in the DISMOUNT command. 


Therefore, in both cases the dismount fails. 


?Disk is mounted public 


Explanation: A user with MOUNT privilege attempted to dismount a 
public disk that was mounted as public, without specifying /PUBLIC in 
the DISMOUNT command, so the dismount fails. 


%Disk is mounted read-only 


Explanation: This warning occurs if you do not specify either read or 
write access ((NOWRITE or /WRITE) when mounting a disk initialized 
as read-only. Therefore, you are granted read access only. 


?Disk needs rebuilding but device is write protected 


Expianation: A privileged user attempted to mount a dirty disk (and 
did not specify (REBUILD or /NOREBUILD), but the device is write 
protected and the automatic rebuilding cannot be performed. Therefore, 
the mount fails. 

?Disk needs rebuilding but you do not have the necessary privilege 


Explanation: This message occurs when a user without MOUNT 
privilege tries to mount a private disk that was not logically dismounted. 
The system manager can correct the situation by rebuilding the disk. 


?Disk pack is locked out 


Explanation: This message occurs when a user without DEVICE 
privilege attempts to open files on a disk restricted to users with 
DEVICE privilege. 

?Disk pack is not mounted 


Explanation: The DISMOUNT command was attempted, but the disk 
pack was not mounted on the specified disk drive. 


??Disk pack mount error 


Explanation: Fatal disk mounting error. The disk is corrupt and 
cannot be successfully mounted with the MOUNT command. 


?Division by zero 


Explanation: The expression specified by the user attempted to divide 
by zero. 


?Dollar signs are not allowed in user logical names 


Explanation: You included dollar signs in the logical name on the 
ASSIGN command. Dollar signs are only allowed in system logical 
names. 
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?Do not specify file name or type 


Explanation: This message can occur with the first parameter of 
the ASSIGN command. Remember to use a space between the first 


parameter (the string you assign) and the second parameter (the name 
you assign it). For example, "ASSIGN DR3: X", not "ASSIGN DR3:X". 


?End of file on device 


Explanation: A READ command was attempted but no data was 
available. Either the file is empty or you attempted to read past the last 
record in the file. 


?Equal sign required 


Explanation: You used a qualifier that requires an argument, but you 
did not give an argument. 


?Error in forms definition <forms-name> 
<error Message> 


Explanation: An error, as the error message in the second line 
describes, was discovered in the forms definition displayed. 


You used a qualifier that requires an argument, but you did not give an 
argument. 


?Error number <nn>(message text is not online) 


Explanation: An I/O error occurred while the system was attempting 
to retrieve an error message. Possible causes could be that the device 
containing the system error file (ERR.SYS) is off line, or that the system 
error file contains a bad block. 


This is a serious error, and should be reported to the system manager. 


?Error opening PBS file <file-spec> 
<error message> 


Explanation: An error, as the error message in the second line 
describes, occurred opening the PBS file indicated. 


<error text> opening setup file <filename> 


Explanation: An error occurred while trying to gain access to the setup 
file. 


<error text> opening speed file 


Explanation: An error occurred while trying to gain access to the speed 
file. The speed is not set and the rest of the command is executed. 


<error text> opening/reading default file 


Explanation: An error occurred while processing the default file. 


<error text> reading setup file <filename> 


Explanation: An error occurred while processing the setup file. 


<error text> reading speed file 


Explanation: An error occurred while processing the speed file. The 
speed is not set and the rest of the command is executed. 
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??Fatal system I/O failure 


Explanation: An I/O error has occurred on the system level. The 
results of the last command are unpredictable. This error is caused by a 
hardware condition. Report such occurrences to your system manager. 


?File does not exist 
Explanation: This message occurs for one of the following reasons: 
e An input file that must be present is not present. 
e A wildcard file specification does not match any files. 


e A file is not accessible because of its assigned protection code. 


?File name required 


Explanation: A file specification you typed does not include a file name, 
but one is needed. 


?File specification required 


Explanation: This error occurs if you specify node:: without a file 
specification (except with DIRECTORY). It also occurs if you have two 
commas with no characters between them in a file specification list. 


?Files cannot be on different nodes 


Explanation: This message occurs with network operations. Each 
input file specification you include in a network command must be on 
the same node. 


?File must be disk 


Explanation: The file specified on the OPEN command was not a disk 
file. 


?Form <form-name> does not exist 


Explanation: The form name you specified was not defined by the 
system manager. See your system manager to find out what form names 
are available. 


?Forms Definition File does not exist 


Explanation: The forms definition file, PBS$:FORMS.SYS does not 
exist. 


?Forms not defined [for server <server-name>] 


Explanation: The forms you specified could not be found in the forms 
definition file. 


?Identification string contains invalid characters 


Explanation: A node identification string was specified which did not 
contain alphanumeric characters. 


?Identification string too long 


Explanation: A node identification string was specified which exceeded 
64 characters. 
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%ID label ignored 


Explanation: You mounted a tape in DOS format and specified an ID 
label. Identification labels are not encoded on DOS tapes; therefore, the 
label you specified is not recognized by the MOUNT command. 


%ID label should be specified when you mount an ANSI tape 


Explanation: You mounted a tape in ANSI format, but did not specify 
the tape identification label. Digital recommends that you specify the 
identification label. Thus, the MOUNT command can verify that the 


tape you selected has been mounted. 


?ID labels don’t match 


Explanation: The identification label you specified does not match the 
identification label encoded on the tape. To correct the problem, specify 
the correct identification label. If you do not know what identification 
label is encoded on the tape, you can omit the ID label from the MOUNT 
command. 


?Illegal byte count for I/O 


Explanation: The range of memory starting at the load address given 
is not available. Refer to the memory status report of a display program 
(SYSTAT or DISPLY) to select an available range of memory. 


?Illegal filename 
Explanation: The file name given in the command contains characters 
other than alphabetic or numeric characters. 

?Ilegal switch usage 


Explanation: A CCL command contains an error in an otherwise valid 
CCL switch (qualifier). For example, you cannot use the /SI:n switch 
without a value for n or a colon; or you cannot specify more than one of 
the same type of CCL switch. 


?Illegal value <n> 
Explanation: The swap file number specified is not 0, 1, or 3. (The 
swap file 2 already exists on the system disk and need not be added.) 
?Impossible density for this device 


Explanation: You tried to mount or initialize a tape, but specified a 
density not available on the tape drive you used. To correct the problem, 
use another drive or specify a different density. 


?Incorrect density 


Explanation: You specified a density different from the tape’s density. 
This message appears only if you are using a tape drive that determines 
the tape’s correct density. Therefore, you do not need to specify the tape 
density with the MOUNT command. 
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?Incorrect density or uninitialized tape 
Explanation: This message can occur for the following reasons: 
e You tried to mount a tape that had not been initialized. 
e You specified an incorrect density. 


e You did not specify a density, and your system default density was 
incorrect for the tape. 


If the tape has not been initialized, use the INITIALIZE command. 
Otherwise, specify the correct density. 


?Invalid account 


Explanation: The account specified was not valid either containing 
invalid characters (for example, [**“%]) or an invalid format (for example, 


[1,2345]). 


?Invalid argument 


Explanation: This error can occur when you use a qualifier in the form 
/qualifier=argument. The qualifier you used is spelled properly, and the 
equal sign (=) or colon (:) is present; however, the argument is either 
missing or syntactically invalid. 


This error message is displayed when there is no more specific messages 
to describe the syntax error. 


?Invalid at interactive level | 


Explanation: You specified a command that is invalid at the interactive | 
level. (For example, GOTO LABEL) | 


?Invalid BATCH command 


Explanation: Although the command is valid in interactive mode, the 
command is not a valid BATCH command because it implies or requires 
interaction with the user. (For example, INQUIRE, SET NODATA) 


?Invalid CCL command 


Explanation: You used the CCL prefix followed by a command that is 
not installed as a CCL command on your system. 


?Invalid channel number 


Explanation: The I/O channel number specified was invalid. Channel 
numbers can range from 1 to 13 on OPEN, READ and CLOSE 
commands, and from 0 to 13 on WRITE commands. | 


?Invalid character 


Explanation: You typed an invalid punctuation character. 


?Invalid characters in service name 


Explanation: The service name does not contain alphanumeric 
characters on a DELETE/SERVICE command. 


?Invalid command 


Explanation: The command name you gave is not a DCL command, 
and is not defined on your system as a CCL command. Or, the line 
begins with a punctuation character rather than with a keyword. 
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?Invalid date 


Explanation: A date either has improper syntax, represents a 
nonexistent date (for example, 30-Feb), or represents a date before 1970 
or after 1999. 


?Invalid density <n> 


Explanation: You tried to mount or initialize a tape, but specified a 
density other than 800 or 1600 bpi. The n is the density you specified. 


?Invalid device 


Explanation: The device specified could not be found in the list of 
standard devices or in the user-defined macros. Specify a valid device. 


?Invalid entry name 


Explanation: The entry name you specified is invalid. 


?Invalid expression 


Explanation: This covers a range of expression problems. The most 
common of these is an expression ending in an operator without 
supplying a second operand (for example, A = B *). 


?Invalid Ethernet Device 


Explanation: The device-name is not valid on a SHOW 
COUNTERS/DEVICE command. 


?Invalid file specification 


Explanation: A local file specification has improper syntax. 


?Invalid fill factor 


Explanation: A fill factor was specified that was less than 0 or greater 
than 6. | 


?Invalid form definition 


Explanation: The definition of the specified form contains an invalid 
keyword or keyword argument. 


?Invalid form name 
Explanation: The form name you specified is either longer than six 
characters or consists of one or more nonalphanumeric characters. 
?Invalid function name 


Explanation: The function name specified after F$ is invalid. The 
minimum abbreviation point is not met for the function (for example, 
F$LE is not valid because of F$SLEFT and F$LEN). 


YInvalid keyboard numbers <n , n> in default file 


Explanation: The numbers you specified in the default file were less 
than 0, greater than 127, or the first number of the range is greater 
than the second number of the range. 
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% Invalid keyboard numbers <n , n> in speed file 


Explanation: The numbers you specified in the speed file were less 
than 0, greater than 127, or the first number of the range is greater 
than the second number of the range. 


?Invalid keyword 


Explanation: The keyword is not recognized. This error occurs with 
keywords that are not qualifiers and are not command names. (For 
example, it can occur with the options of SET and SHOW, and with 
qualifier values that are keywords.) 


?Invalid label 


Explanation: The label specified in the command procedure contains 
invalid characters. 


?Invalid node name 


Explanation: The node name field of the file specification contained 
invalid characters. 


?Invalid operator 


Explanation: The operator you specified in the expression is not a 
defined logical, arithmetic, string, arithmetic comparison or string 
comparison operator. 


?Invalid PPN 


Explanation: The project-programmer number (PPN) you specified 
does not have valid syntax. 


?Invalid print device 


Explanation: The device you specified is not a valid print device 
because it is not a line printer or terminal. 


?Invalid private delimiter 


Explanation: The delimiter you specified was not in one of the correct 
formats. 


?Invalid qualifier 


Explanation: The qualifier keyword is not valid in the command you 
typed. (This message may indicate an error in spelling or typing.) 


?Invalid qualifier for disk 


Explanation: This message occurs when you specify an invalid qualifier 
for disks. For example, /FORMAT=ANSI (applies to tapes). 


?Invalid qualifier for tape 


Explanation: This message occurs when you specify an invalid qualifier 
for tapes. For example, /PRIVATE (applies to disks). 


?Invalid queue name 


Explanation: The queue name you specified is invalid. 
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?Invalid server name 


Explanation: The server name you specified is invalid. 


?Invalid speed 


Explanation: The speed specified was not a valid speed for the interface 
of the terminal. Only specify speeds that the interface supports. 


?Invalid symbol name 
Explanation: You specified a symbol name that contains invalid 
characters. 

?Invalid time 


Explanation: A time either has improper syntax or represents a 
nonexistent time (like 25:00 or 13:00PM). 


?Invalid width 
Explanation: You specified a width that was less than 1 or greater 
than 254. 

?Invalid with network file specification 


Explanation: You gave a network file specification in one of the 
commands that accepts them (RENAME, COPY, and so on), but you also 
gave a qualifier that can be used only with local operations. 

?1/O to detached keyboard 


Explanation: This message can result from one of two actions: 


e¢ You tried to perform I/O with a terminal line that is used for dialup 
terminals, but nobody was dialed in. 


e Your job became detached (perhaps because you were dialed in and 
your line was later hung up) and then tried to perform I/O with the 
terminal. 


The second situation either causes the job to hibernate or causes this 
error condition, after which the job hibernates. You see this message 
when you subsequently attach to the job. 

?Keyword required 


Explanation: You typed nonalphanumeric characters when a keyword 
is needed instead. (If you type alphanumeric characters without a valid 
keyword, you receive the error message, ?Invalid keyword.) 


?Label already defined 


Explanation: A label was defined more than once in an indirect 
command procedure. 


?Label too long 


Explanation: The label you specified in the indirect command proce- 
dure was longer than 255 characters. 


?LAT already started on this line 


Explanation: A LAT service was already enabled when you attempted 
to open another LAT line using the START/LAT command. 
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?LAT not started 


Explanation: A STOP/LAT command has been issued and there is no 
active LAT service enabled. 


?Log file already open 


Explanation: A log file was already currently open when you attempted 
to open another log file using the OPEN/LOG_FILE command. 


?Log file not currently open 


Explanation: You attempted to enable or disable logging using the SET 
LOG_FILE command, and a log file did not exist. 


?Log file print queue closed 


Explanation: The print queue required for a SUBMIT command’s 
/LOG_QUEUE qualifier is closed or marked for deletion. Use a different 
print queue for the log file. 


?Log file print queue does not exist 


Explanation: The print queue you specified with the /LOG_QUEUE 
qualifier in a SUBMIT command does not exist. Specify a different 
queue. 


%Logical name not assigned 
Explanation: This warning can be displayed for one of two reasons: 


e You had INSTAL privilege and specified a logical name that was not 
assigned as a system logical. (This means that neither the alternate 
logical name nor the pack-id label were assigned. ) 


e You did not have INSTAL privilege and specified an alternate logical 
name when attempting to mount a disk. 


The mount succeeds in both cases, but the logical name is not assigned. 


?Logical too long 


Explanation: Logical name was over 15 characters. 


?Magtape record length error 


Explanation: When performing input from magnetic tape, the record 
on tape was found to be longer than the buffer designated to handle the 
record. 


?Magtape select error 


Explanation: When access to a magnetic tape drive was attempted, the 
selected unit was found to be off line. This error can occur when you 
transfer data to or from a tape. 

?Map or executable file required 


Explanation: With LINK, you specified /(NOEXECUTABLE and did not 
specify a map file. 
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??Maximum memory exceeded 


Explanation: This is a nonrecoverable RSTS/E error caused by the 
following conditions: 


e While loading a program into memory, the job’s private maximum 
memory size was reached. 


e While executing a program, the system required more memory for 
string or I/O buffer space, and the job’s private maximum memory 
size or the system maximum was reached. 

?Maximum number of LAT lines already enabled 
Explanation: The number of LAT lines on the Ethernet portal has 
reached the limit on a START/LAT command. 

?Missing closing apostrophe 
Explanation: The user did not specify matching apostrophes (’... ’) 
when requesting apostrophe substitution. 

?Missing closing bracket 


Explanation: This error can occur in a local or remote file specification. 
There is a left bracket ([) or left angle bracket (<), but no right bracket 
(]) or right angle bracket (>). 

?Missing closing quote 
Explanation: A quotation mark (") is not matched with another 
quotation mark. (This error can occur in remote file specifications.) 


?Missing device or file name 


Explanation: The command must contain either a device specification 
or a device and file name specification. If you use the /SI:n switch, a file 
name must be present. 


?Missing open parenthesis 


Explanation: You did not specify an open parenthesis [(] when one was 
expected. 


%More than 16 speeds specified for <terminal> 


Explanation: While processing the TERSPD.SYS file, a terminal was 
found that had more than 16 speeds specified. Only the first 16 speeds 
are used. 


?Name or account now exists 


Explanation: You attempted either to COPY to or RENAME an 
existing file. This error can occur with RENAME if you do not specify 
/REPLACE and the output file already exists. It can also occur with 
COPY if you specify /(NOREPLACE and the output file already exists. 


?Network node names must be the same 


Explanation: Different node names were specified on input file 
specifications. 
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2No active LAT sessions [on server-name] 
Explanation: There is no active session on the specified server on a 
"SHOW SESSION [server-name]" command. 

?No active servers 
Explanation: A terminal server name has been entered and the 
specified server is not active. 

?No buffer space available 


Explanation: The system is overloaded and cannot complete your 
command because small buffers are currently unavailable. Try the 
command again later. 


%No commands to recall 


Explanation: RECALL/ALL command was issued when no commands 
were available for recall. Check that Command Line Recall is enabled 
by using the SHOW TERMINAL command. 

2No channels available 


Explanation: A DCL I/O or command file channel is not available. 

You may have issued an OPEN or at (@) command, but a channel is not 
available. Use the CLOSE command to close one or more files or use the 
EXIT command to unnest a level and try again. 


?No default (Print,Batch) queue 
Explanation: You did not specify a queue name with the PRINT or | 
SUBMIT command, and no default queue exists. | 
| 
?No default print queue for log file 


Explanation: The /LOG_QUEUE qualifier in a SUBMIT command 
was specified without an explicit queue name; however, no default print 
queue exists. Use an explicit queue name for the log file. 


?No file name or type permitted 


Explanation: A device:ppn syntax was expected and you supplied a full 
file specification which included either a file name or type. 


2No known terminal servers 


Explanation: All terminal servers are requested to be displayed and 
none exists on a "SHOW TERMINAL_SERVER/LAT" command. 


2No LAT Node characteristics set 


Explanation: The Ethernet device has not been specified on a 
START/LAT command. 


?No LAT services currently offered 


Explanation: No LAT services are available on a SHOW 
TERMINAL/LAT command. 
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?No logins 


Explanation: This message can be displayed when you try to log in, for 
one of two reasons: 


e The system is full, so it cannot accept additional users. 


e The system manager has disabled logins. 


(Possibly, logins are disabled because the system will be shut down 
shortly.) 


?Non-executable file 


Explanation: This error occurs if the file you are trying to run is a 
source file; for example, .BAS. You need to compile and link the file 
before you run it. (Note that an executable file includes the value 64 in 
its protection code.) 


?Non-printable character 


Explanation: You typed a control character. 


??Non-res run-time system 


Explanation: This message generally indicates hardware problems. 
For example, the run-time system referenced has not been loaded 
into memory and cannot be loaded for some reason, and is therefore 
nonresident. 


%No owner rights to (print,batch) entry <entry-spec> 


Explanation: The entry shown is not your own and you do not have 
sufficient privilege to delete it or modify it. 


?NO prefix not allowed 
Explanation: You used the /NO prefix improperly. 


%No (Print,Batch) entry <entry-spec> found 


Explanation: No entries matching the entry-spec you specified in a 
SHOW ENTRY or SET ENTRY command were found. 


JNo (Print,Batch) queue <queue-name> found 


Explanation: No queues matching the queue name you specified in a 
SHOW QUEUE or SET QUEVE command were found. 


%No (Print,Batch) server <server-name> found 


Explanation: No servers matching the server name you specified in a 
SHOW SERVER or SET SERVER command were found. 


?No qualifiers allowed 


Explanation: The user specified a qualifier on a command that does 
not allow qualifiers. 


?No (read,write,or read/write) access to file <file-spec> [by owner] 


Explanation: The file specifications in a PRINT or SUBMIT command 
requires access that you or the specified owner does not have. 
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2No room available for new LAT Service 


Explanation: The system does not have enough resources to add 
another LAT service on a CREATE/SERVICE command. 


?No room for user on device 


Explanation: In attempting to create a file on a device, or write 
information to a device, you exceeded some size limit. If it was a 
nondisk device, this error indicates that the device was full. If it was a 
disk device, this error indicates one of three conditions: 


e The disk as a whole is full. 


¢ You attempted to create a contiguous file, and there is not enough 
space on the disk. (However, the /CONTIGUOUS qualifier for the 
commands COPY and CREATE produce only a warning if there is 
not enough contiguous space. 


If you attempted to create a contiguous file but were unable to, try to 
create a noncontiguous file of the same size. If you are able to create 
a noncontiguous file then you can conclude the problem is lack of 
contiguous space. 


° If you have eliminated the first two conditions, then the disk 
directory has reached its capacity. This capacity is independent of 
your disk quota. The number varies, depending on the directory 
cluster size that the system manager assigned when creating the 
directory and the sizes of the files in it. Large files fill up a directory 
faster than small files, especially if the large files have small cluster 
sizes. Also, if the directory itself has a large cluster size, it can hold 
more files and larger files. 


?No run-time system 


Explanation: This error can occur if the program you are trying to run 
requires a run-time system that is not installed. 


?Not a valid device 


Explanation: The device name that you gave is invalid for any of the 
following reasons: 


e Itis not assigned as a systemwide or user logical name. 


e Itis not a physical device name of any device that is installed on 
your system. 


e The device name is valid, but not with this command. For example, 
"INITIALIZE TT:" (you cannot initialize a terminal). 


2Not a valid LAT line 


Explanation: The server specified is not valid on a "SHOW SESSIONS 
server-name' command. 


?Not enough available memory 


Explanation: An attempt was made to load an executable program that 
is too large to run, given the job’s private maximum memory size. Either 
the program must be allowed to expand above a private maximum 
memory size, or the system manager must increase the job’s private 
Memory size maximum to accommodate the program. 
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?Not enough small buffers to create the logical terminal 
Explanation: The system does not have enough small buffers to add 
another logical terminal on a CREATE/PORT command. 

?Number not in range <low> or <high> 


Explanation: You typed a number where one is allowed, but the 
number is not in the valid range. The valid range is from <low> to 
<high>. 

?Number too big 


Explanation: You typed a number where one is allowed, but the 
number is too large. Refer to the command description to find out the 
largest acceptable value. 


?Number too small 


Explanation: You typed a number where one is allowed, but the 
number is too small. Refer to the command description to find out the 
smallest acceptable value. 


?Pack-id labels don’t match 
Explanation: The identification code for the specified disk pack does 
not match the identification code already on the pack. This message can 
occur when you try to mount or dismount a disk. 

?Page limit exceeds queue’s maximum 
Explanation: You specified a /PAGE_LIMIT value in a PRINT 
command larger than the maximum allowed for the queue. 

?Parameter out of range 


Explanation: Numeric parameter was not in the range of accepted 
values. 


?Parameter or argument too long 
Explanation: A file specification, text string, or qualifier argument 
exceeded 127 characters. 

?Port [port-name] does not exist 


Explanation: The device specified is not a LAT port on a SHOW PORT 
command. Port names must be in the format "KBn’". 


2?PPN does not exist 


Explanation: The project-programmer number (PPN) you specified as 
part of the job specification does not exist. 


?PPN needed 
Explanation: The command you typed requires that a PPN be specified. 


Previous logical name assignment replaced 


Explanation: An informational message to indicate that an ASSIGN 
command redefined a previously defined user logical. 
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(Print,Batch) entry <entry-number> <entry-spec> created 
Explanation: Acknowledgment message to PRINT or SUBMIT 
command. 

(Print,Batch) entry <entry-spec> - <error text> 
Explanation: For SET ENTRY, indicates that an entry was not 
modified for the reason stated in the error text. 

?Print/Batch Services already started 
Explanation: You issued the START/QUEUE/MANAGER command; 
however, the Print/Batch Services (PBS) package is already started. 

?Print/Batch services not running 
Explanation: You issued a command that requires action by PBS; 
however, the package is not running. 

(Print,Batch) queue <queue-name> assigned to server <server-name> 
Explanation: Acknowledgment message for ASSIGN/QUEUE com- 
mand. 

(Print,Batch) queue <queue-name> deassigned from server <server-name> 
Explanation: Acknowledgment message for DEASSIGN/QUEUE 
command. 

(Print,Batch) queue <queue-name> closed 


Explanation: Acknowledgment message for CLOSE/QUEUE command. 


(Print,Batch) queue <queue-name> deleted 
Explanation: Acknowledgment message for DELETE/QUEUE com- 
mand. 

%(Print,Batch) queue <queue-name> - <error text> 
Explanation: For SET QUEUE, indicates that a queue was not 
modified for the reason stated in the error text. 

(Print,Batch) queue <queue-name> marked for deletion 


Explanation: Acknowledgment message for DELETE/QUEUE 
command when the queue you specified still has entries on it. The queue 
is deleted as soon as it becomes empty. 


(Print,Batch) queue <queue-name> opened 


Explanation: Acknowledgment message for OPEN/QUEUE command. 


(Print,Batch) queue <queue-name> started 


Explanation: Acknowledgment message for START/QUEUE command. 


(Print,Batch) queue <queue-name> stopped 


Explanation: Acknowledgment message for STOP/QUEUE command. 


(Print,Batch) server <server-name> (deleted,marked for deletion) 


Explanation: Acknowledgment message for DELETE/SERVER 
command. 
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%(Print,Batch) server <server-name> - <error text> 


Explanation: For SET SERVER, indicates that a server was not 
modified for the reason stated in the error text. 


(Print,Batch) server <server-name> initialized [non-]shareable 
[with forms <form-name>] 


Explanation: Acknowledgment message for INITIALIZE/SERVER 
command. 


(Print,Batch) server <server-name> modified 


Explanation: Acknowledgment message for SET SERVER command. 


(Print,Batch) server <server-name> started 


Explanation: Acknowledgment message for START/SERVER command. 


(Print,Batch) server <server-name> stopped 


Explanation: Acknowledgment message for STOP/SERVER command. 


Print/Batch Services started at <time> 
Explanation: Acknowledgment message when you issue the 
START/QUEUE/MANAGER command to begin Print/Batch Services. 
Print/Batch Services stopped at <time> 


Explanation: Acknowledgment message for STOP/QUEUE/MANAGER 
command if no jobs are being processed. 


Print/Batch Services will stop after (completing,aborting) <n> job[s] 


Explanation: Acknowledgment message for STOP/QUEUE/MANAGER 
command if any jobs are currently in progress. 


?Priority exceeds queue’s maximum 


Explanation: You specified a priority for a PRINT or SUBMIT entry 
larger than the maximum allowed for the queue. 


?<privilege> privilege required 
Explanation: You typed a command that requires some privilege, and 
you do not have it. 


??Program failure in <program-name> 


Explanation: This message reports a problem in the software. It is 
followed on the next line by an explanation of the problem. You should 
verify that the failing program is correctly installed. If necessary, you 
should then submit an SPR. The SPR should show the dialogue that 
preceded the message, the exact text of the message, and a list of 
patches that have been installed in the failing program. 


?Program PBS$:PBS.TSK does not exist 


Explanation: The Print/Batch Services (PBS) program was not found 
when you issued the START/QUEUE/MANAGER command. 
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?Protection violation 
Explanation: This error can occur for reasons similar to the following: 


¢ You typed a CCL command that your system manager has protected 
against general use. , 


e You tried to run a program to which you do not have execute access. 
e You tried to read a file to which you do not have read access. 
e You tried to write to or delete a file to which you do not have write 


access. 


If this message occurs because of a protection violation with one of your 
own files, you can use the SET PROTECTION command to change the 
file’s protection code. (However, this error can also occur because of other 
conditions. ) 

%Public disk mounted as private 


Explanation: A user with MOUNT privilege mounted a disk initial- 
ized as public without specifying /PRIVATE, /PUBLIC, /SHARE, or 
/NOSHARE. The system mounts the disk as private. 

?Qualifier conflicts with file type 
Explanation: You specified the /APPEND qualifier and the file has 
RMS attributes. 

?Qualifier conflicts with parameter 


Explanation: You typed a parameter and a qualifier that should not 
be present together. For example, with the DEASSIGN command, you 
specified the /ALL qualifier and a logical name. 

?Queue already assigned to server 


Explanation: You issued an ASSIGN/QUEUE for a queue already 
assigned to the server you specified. Use the SHOW QUEUE/FULL 
command to see which servers are assigned to a queue. 


?Queue does not exist 


Explanation: You specified the name of a queue that does not exst. 


?Queue is (closed,deleted) 


Explanation: A PRINT or SUBMIT command entry could not be 
created on a queue because the queue is closed or marked for deletion. 
Use a different queue. 


?Queue is privileged 
Explanation: The queue you specified in a PRINT or SUBMIT com- 
mand requires one or more privileges that you do not have. Use the 
SHOW QUEUE/FULL command to display the privileges that the queue 
requires. 

?Queue manager message queue full 


Explanation: There is no room for additional messages to be sent to 
PBS at this time. Reissue the request. 


DCL Error Messages A-23 


?Quoted string expected 
Explanation: A quoted string or character was expected and was either 
missing or was not enclosed in quotes. 

%Record too long, line truncated 
Explanation: The record on a READ command was too long. The 
assignment occurred; however, only the first 255 characters were pro- 
cessed. 

?Remote port name cannot exceed 16 characters 
Explanation: The remote port name is longer than 16 characters on a 
CREATE/PORT, ASSIGN/PORT or SET PORT command. 

?Reserved symbol name 
Explanation: The user attempted to define a local or global symbol 
which began with a reserved prefix of $, F$ or f$, or delete a reserved 
global symbol from the symbol table that began with $. 

?Server already exists 
Explanation: You issued the INITIALIZE/SERVER command to define 
a server that already exists. 

?Server does not exist 


Explanation: You specified the name of a print or batch server that 
does not exist. Use the SHOW SERVER command to list the defined 
servers. 


?Server [server-name] does not exist 
Explanation: A SHOW TERMINAL [server-name] command was 
entered and the specified server does not exist. 

?Server name cannot exceed 16 characters 


Explanation: The terminal server name is longer than 16 characters 
on a CREATE/PORT or ASSIGN/PORT command. 


?service name cannot exceed 16 characters 


Explanation: The service name is longer than 16 characters on a 
CREATE/PORT, ASSIGN/PORT or SET PORT command. 


?Service [service-name] already exists 


Explanation: The LAT service already exists on a CREATE/SERVICE 
command. 


?Service [service-name] does not exist 


Explanation: The specified service does not exist. 


?Single character expected 


Explanation: A single character inside quotes was expected and more 
than one character was supplied (for example, SET DATA/END_OF_ 
DATA = "$$"). 
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?Speed is not allowed for <terminal> 


Explanation: The speed specified is not one of the speeds allowed for 
this terminal in the TERSPD.SYS file. 


??Stack overflow 


Explanation: This message indicates a system problem. The system 
manager should send in an SPR, giving the dialogue that preceded the 
message, the text of the message, and a list of patches that have been 
installed. 

?String too long 
Explanation: While in an expression, a string became too long to fit in 
the 255 available bytes. 


?Substitution too complex 


Explanation: The user’s request for apostrophe substitution was 
rejected because the substitution was too complex. It reached the 
maximum number of substitution iterations allowed on one command. 


?Symbol name conflicts with <symbol-name> 


Explanation: The user specified an assignment whose symbol name or 
abbreviation point conflicted with an existing symbol definition in the 
same symbol table. 

?Symbol name too long 
Explanation: The symbol name specified by the user exceeded 255 
characters. 


%Symbol table almost full 


Explanation: This warning is issued when your local or global symbol 
table has less than 100 free bytes. 


??Symbol table full 


Explanation: You attempted to define a label or symbol when the local 
or global symbol table was already filled up. Note that if you are ina 
command procedure when your symbol table gets full, the command 
procedure aborts. 

?Syntax error 
Explanation: The command has improper syntax. This occurs when 
there is not a more specific message describing the syntax error. 


?That port is currently in use 


Explanation: The port already exists on a "CREATE PORT port-name' 
command. 


?The port name specified is not a dynamic keyboard 
Explanation: The port-name is invalid on a CREATE/PORT port-name 
command. Port names must be in the format "KBn". 

?The port name specified is not a LAT port 


Explanation: The port-name is invalid on a SHOW PORT command. 
Port names must be in the format "KBn". 
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?The port name specified is not an outbound LAT port 


Explanation: The port-name is invalid on a SET PORT, ASSIGN/PORT, 
DEASSIGN/PORT or DELETE/PORT command. Port names must be 

in the format "KBn". The specified keyboard must have already been 
created as an application port with the CREATE/PORT command. 


?’THEN clause required 
Explanation: The action clause was missing on the IF <expression> 
THEN command or on the ON <severity-level> THEN command. 
?THEN keyword required 
Explanation: The THEN keyword was missing on the IF <expression> 
THEN command or on the ON <severity-level> THEN command. 
?Time limit exceeds queue’s maximum 
Explanation: You specified a /TIME_LIMIT value in a SUBMIT com- 
mand larger than the maximum allowed for the queue. 
?Too many arguments 
Explanation: You used the notation /qualifier=(arg,arg,...) witha 
qualifier that accepts only a single argument. 
?Too many elements in list 


Explanation: In a list of file specifications or other items (separated by 
commas or plus signs), you indicated more file specifications than are 
allowed. For example, you exceeded one of the following limits: 


¢ The DIBOL, RENAME, DELETE, and SET PROTECTION com- 
mands allow six file specifications. 


e The COPY command allows six input file specifications and one 
output file specification. 


¢ The PRINT and SUBMIT commands allow up to 11 file specifica- 


tions. 


?Too many files or parameters 


Explanation: You specified too many file specifications in a PRINT or 
SUBMIT command, or a parameter string in a SUBMIT command is too 
long to be handled by PBS. Reduce the number of file specifications or 
use a shorter parameter string. 


?Too many logical names assigned 


Explanation: With the ASSIGN command, you exceeded the maximum 
number of logical names. You can only assign up to four logical names 


(only three logical names if any of the logical assignments includes a 
PPN). 


?Too many open files on unit 


Explanation: You specified the same magnetic tape or DECtape drive 
both as input and output files on COPY or APPEND. 
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?Too many parameters 


Explanation: This message occurs if you specify more command param- 
eters than the command can accept. For example, you specified more 
than eight parameters with the /PARAMETERS qualifier. 


?Too many printers initialized 


Explanation: The device you specified could not be initialized because 
the maximum number of spooling devices has already been initialized. 


?Unable to copy tape command file to disk 


Explanation: The user specified an indirect command file on magnetic 
tape, and some error occurred when attempting to copy it to a temporary 
disk file for processing. 


??Unable to create DCL work file 


Explanation: DCL’s work file for storing the user’s symbol tables could 
not be created on disk. The user may be over quota. Corrective action 
should be taken before the user continues processing. 


??Unable to read DCL work file 


Explanation: The user’s symbol tables could not be read in from the 
DCL work file. If RSTS/E is processing an indirect command file, then 
control immediately returns to the interactive level. 


?Unable to start Print/Batch Services 
<error message> 


Explanation: Some external condition, as the error message on the 
second line describes, prevented PBS from being started. 


??Unable to write DCL work file 


Explanation: The user’s symbol tables could not be written out to the 
DCL work file. The user may be over quota. Corrective action should 
be taken before the user continues processing. If RSTS/E is processing 
an indirect command file, then control immediately returns to the 
interactive level. 


?Unbalanced parentheses 


Explanation: Parentheses do not match up (for example, A=((5)+6). 


?Undefined label <label> 


Explanation: The label specified on the GOTO command does not exist 
in the indirect command procedure being executed. 


?Undefined symbol 


Explanation: The symbol name specified is not defined in the global or 
local symbol tables. 


?Unexpected character 


Explanation: A character was encountered in a qualifier or a parame- 
ter that was not expected. For example, in 

SET TERMINAL/WIDTH=80FO0O, the "F" of "FOO" would be an unex- 
pected character. 
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?Unit number required 


Explanation: This message occurs when you specify a device-name 
without a device-number (for example, DM: instead of DM0:). 


?User macros nested too deep 


Explanation: There were more than 50 nested user macros or a user 
macro called itself. 


?Wildcard entry name not allowed 


Explanation: The command you specified does not allow wildcard entry 
names. Specify the name of a single entry instead. 


?Wildcards not allowed 


Explanation: You included a wildcard in a file specification, where 
_ Wildcards are not allowed. 


?Wildcard PPN not allowed 


Explanation: The command you specified does not allow wildcard 
PPNs. Specify the name of a single PPN instead. 


?Wildcard queue name not allowed 
Explanation: The command you specified does not allow wildcard 
queue names. Specify the name of a single queue instead. 

?You need MOUNT privilege to dismount a public disk 


Explanation: This message occurs when a user without MOUNT 
privilege tries to dismount a disk initialized as public. A user without 
MOUNT privilege can dismount only private disks. 


?You need MOUNT privilege to mount a public disk 


Explanation: This message occurs when a user without MOUNT 
privilege tries to mount a disk initialized as public. A user without 
MOUNT privilege can mount only private disks. 


?You must have MOUNT privilege to rebuild the disk 


Explanation: This message occurs when a user without MOUNT 
privilege attempts to rebuild a private disk with the /REBUILD qualifier 
of the MOUNT command. Have your system manager rebuild the disk. 
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Appendix B 


More About Command Environments and RSTS/E 
File Specification 


This appendix provides information primarily for users who are familiar with 
earlier versions (V9.0 and before) of RSTS/E, especially those users who work 
mostly within command environments other than DCL. 


B.1 More About Command Environments 


Chapter 1 discusses the four RSTS/E command environments: DCL, BASIC- 
PLUS, RT11, and RSX. Each offers its own advantages. Each command 
environment has its own prompt: 


Prompt Environment 
$ Digital Command Language (DCL) environment 
Ready BASIC-PLUS environment 


RT11 environment 


> RSX environment 


Since DCL is the default command environment on RSTS/E, this manual has 
already described many DCL commands to help you in your work. If you want 
to switch to one of the other command environments, see the appropriate 


documentation for complete descriptions of the commands you can use in 
BASIC-PLUS, RT11, and RSX. 


B.1.1 Switching Between Command Environments 


DCL is the default RSTS/E command environment. You can switch to another, 
however. Use the following command to switch to and from any command 
environment: 
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$ SET JOB/KEYBOARD MONITOR=[command environment name] 


The command environment name can be any one of the following: 


e DCL 

e BASIC 
° RT11 

e RSX 
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The system transfers control to that keyboard monitor, establishing it as your "job 
keyboard monitor." That is, you can type commands to the keyboard monitor you 
switched to until you switch again, or logout of the system. 


NOTE 


You can issue DCL commands from any keyboard monitor by typing 
the $ character followed by the command. For example, if you are in 
the BASIC-PLUS command environment and you want to use the DCL 
SHOW USER command, type: 


$SHOW USER 


DCL will execute the SHOW USER command, then automatically 
return to the BASIC-PLUS environment. 


Note that if you type the $ character with no command, you will switch 
back into the DCL command environment. 


B.1.2 BASIC-PLUS Keyboard Monitor Commands 


The BASIC-PLUS command environment provides commands useful to the 
BASIC-PLUS programmer on RSTS/E systems. The BASIC-PLUS interpreter 
lets you type in a program using BASIC-PLUS statements that are translated 
and stored in your job area. 


Many of the BASIC-PLUS commands (which are distinct from language state- 
ments) let you list, compile, store, and otherwise work with the BASIC-PLUS 
program you create. Note, however, that BASIC-PLUS has a very powerful fea- 
ture, called "immediate mode" that allows you to type many language statements 
as though they were commands. 


Table B—1 briefly describes BASIC-PLUS commands. See the BASIC-PLUS 
Language Manual for a complete description of BASIC-PLUS commands. 


Table B—1: BASIC-PLUS Commands 


Command Description 

APPEND Includes the contents of a previously saved source program into 
the current program. 

CAT or CATALOG Displays the file directory for your account. Unless another 


device is specified following the term CAT or CATALOG, the 
public disk structure is the assumed device. 


CCONT Can be used by privileged users only. The command operates 
the same as the CONT command, but detaches the job from the 
terminal. 

COMPILE Allows you to store a translated version of your BASIC program. 


The file is stored on disk with the current name and the file type 
.BAC. Or, you can specify a new file name and type. 


CONT Allows you to continue execution of the program currently in 
memory following the execution of a STOP statement. 


(continued on next page) 
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B.1.3 RI11 


Table B—1 (Cont.): 


Command 


DELETE 


EXIT 
KEY 


LENGTH 


LIST 


LISTNH 


NEW 


TAPE 


UNSAVE 


BASIC-PLUS Commands 


Description 


Allows you to remove one or more lines from the program 
currently in memory. After the word DELETE, type the line 
number of the single line to be deleted or two line numbers 
separated by a hyphen (-) indicating the first and last line of 
the section of code to be removed. Several single lines or line 
sections can be indicated by separating the line numbers, or line 
number pairs, with a comma. 


Returns you to the job keyboard monitor. 


Reenables the echo feature on the terminal after a TAPE 
command. Enter with the LINE FEED or ESCAPE key. 


Displays the length of the current program in memory, in 1K 
increments. 


Displays the program currently in memory at your terminal. 
You can list the entire program currently in memory, or one or 
more lines of that program. 


Does the same thing as LIST, except that it does not print a 
header containing the program name and current date. 


Clears your area in memory and allows you to input a new 
program from the terminal. You indicate a program name 
following NEW or when the system requests it. 

Clears your area in memory and allows you to recall a saved 
program from a storage device. You indicate a program name 
following the word OLD or when BASIC-PLUS requests it. 


Lets you change the name of the program currently in memory. 
Lets you begin execution of the program currently in memory. 


Or, if the RUN command is followed by a file specification, in- 
cluding device and account if desired, you can run any program. 


Executes the program currently in memory, but does not print 
header information with the program name and current date. 
Saves the source program currently in memory in a file on the 
system disk, under its current name with the file type of .BAS. 
Or, you can give a complete file specification (including device 
and account). 


Sets the scale factor to a designated value or displays the values 
currently in effect if no value is designated. 


Disables the echo feature on the terminal; this is useful if you 
are using a terminal with a paper-tape reader. 


Deletes the file specified. 


Keyboard Monitor Commands 


The RT11 Run-Time System has a keyboard monitor. If you switch control to 
RT11, a period (.) prompt displays, and you can type commands. You can use the 
standard RSTS/E commands ASSIGN, BYE, DEASSIGN, HELLO, and MOUNT. 


Table B—2 briefly describes RT11 commands. 
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Table B—2: RT11 Commands 


Command 


B/E/D 


CCO[NTINUE] 


COLNTINUE] 


CLLOSE] 
DATE 
ER[LROR] 


GET] 


INITIALIZE] 


LOCK 


MO[NITOR] 


Description 


The commands B, E, and D let you examine memory locations, 
as follows: 


e B <address>—Sets a base address from which offsets in E 
and D commands are computed. Initially, the base is 0. 


e E <offset>—Prints the contents of location <address> + 
<offset>. 

° D <offset> <value>—Replaces the contents of location 
<address-> + <offset> with <value>. 

Any address from 0 to 177777 is valid for these commands; 

however, addresses outside your current job image area (as 

determined by the SIZE command) will give an error. 


Resumes the execution, as a detached job, of a program that was 
stopped by a CTRL. If, for any reason, the program cannot 

be restarted, the error message ?Can’t continue displays on the 
terminal. 


Resumes execution of a program stopped by a CTRL. If, for 
any reason, the program cannot be restarted, the error message 
?Can’t continue displays on the terminal. 


Closes all open channels. Tentative files are made permanent. 
Displays the current date on the job’s terminal. 

Prints the RSTS/E error message text associated with the last 
encountered error, if there was one. For example, any failure 
on file lookup gives an error message similar to ?Fil not fnd?. 
Typing CTRL/C to return to RT11’s period prompt (.) and then 


typing ERR will print the full RSTS/E error message for the 
error encountered; for example, can’t find file or account. 


Loads an RT11-executable file (with a file type of .SAV) into 
memory, but does not execute it. (The START command is used 
to run programs loaded with GET.) No automatic expansion 

of the job image area occurs with GET; you must use SIZE if 
necessary. 


Loading for GET differs from R or RUN in that certain low-core 
areas are preserved rather than loaded from block 0 of the .SAV 
file. 

Resets all RT11 conditions, except for logical assignments, to the 
state they are in when RT11 is first entered as the job keyboard 
monitor. 


Denies access to a disk pack by users with insufficient privileges. 
The format is: 

LOCK dev: 

where dev: is the device designation for the disk. 


Exits to the job keyboard monitor. This will be the default 
keyboard monitor unless you have run the SWITCH utility to 
set a job keyboard monitor. 
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Table B-2 (Cont.): RT11 Commands 


Command 


R 


RELENTER] 


RN 


RU 


RUN 


SH[UTUP] 


SI[ZE] 


ST[ART] 


TI[ME] 


Description 


Runs a program from the system library account. The file can be 
associated with any run-time system. For example, R LINK has 
the same effect as RUN $LINK. 


The R command will automatically expand the user job image 
area, if necessary. 


Reenters or restarts a program already in memory whose 
execution has been halted. Bit 13 in the Job Status Word (see 
the RSTS/E System Directives Manual) must be set to allow a 
restart. If it is set, execution begins at the address specified by 
the contents of word 40 in the low 1000 bytes of virtual memory. 
All channels are reset (see .SRESET directive, RSTS/E System 
Directives Manual) unless the chain bit (bit 8 of the Job Status 
Word) is set. If restart is not possible, the message ?No restart 
is displayed on the terminal. 


Loads the file named (from the user’s account if no project pro- 
grammer number is given) and begins execution. The program 
may be associated with any run-time system. If necessary, the 
user job image area is automatically expanded for the program 
to be loaded and run. The RN and R commands are identical 
except for the accounts searched for the file when no explicit 
project-programmer number is given. 


RU is the same as a GET followed by a START. You must 
use SIZE to expand the user job image area, if necessary; no 
automatic expansion occurs with RU. 


This command is passed on by the RT11 run-time system to 
the RSTS/E monitor — it works the same in any command 
environment. 


If (1) only one job is running on the system, (2) logins are 
disabled, (3) no disks except the system disk are mounted, and 
(4) no files are open on the system disk, then the SHUTUP 
command logs the current job off the system and bootstraps the 
initialization code after the job is logged off. 


Sets the size available for an RT11 program, in K words. When 
the RT11 run-time system is entered, the size is set to 2K words. 
To see the current size, type SIZE without a value. 


You must use SIZE to insure enough memory before typing 

a GET or RU command. The job image area is automatically 
expanded for R and RN commands, from information carried in 
the file itself. However, a size given with SIZE overrides any 
computed value (for R and RN) if the computed value is smaller 
than the SIZE value. 


Starts a program loaded with GET. The format of the command 
is: 


ST[ART] [addr] 


where addr is an even octal number specifying the address 
where program execution is to begin. If addr is omitted or 0, 
execution begins with the address in location 40 in the low 1000 
bytes of memory. 


Displays the current time of day at the job’s terminal. 


(continued on next page) 
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Table B—2 (Cont.): RT11 Commands 


Command Description 


UNLOCK Unlocks a disk pack, so that programs running under non- 
privileged accounts can open files on the disk. The format 
is: 
UNLOCK dev: 
where dev: is the device designation of the disk to be unlocked. 


VE[RSION] Prints the current emulator version number. 


B.1.4 RSX Keyboard Monitor Commands 


The RSX run-time system has a keyboard monitor. If you switch control to RSX, 
an angle bracket (>) prompt is displayed. You can use the standard RSTS/E 
commands ASSIGN, BYE, DEASSIGN, HELLO, and MOUNT. 


Table B—3 briefly describes RSX commands. 


Table B-3: RSX Commands 


Command Description 

DISMOUNT Prepares a device for dismounting, so that you can remove a 
disk pack of magnetic tape from a device. The format of the 
command is: 


DISMOUNT dev: 

UNSAVE Deletes a specifically named file from your account. The format 
of the command is: 
UNSAVE filename.type 

SHUTUP Shuts down the system if no other jobs are running on the 


system, all disks are dismounted, all other run-time systems are 
removed, and no logins are allowed. 


B.2 More About The RSTS/E File Specification 


Many commands in the environments discussed in the previous section require 
that you identify a file to serve as either input or output to the command. 


This section provides further information on specifying RSTS/E files in these 
command environments. 


The general form for a RSTS/E file specification is: 
device:[project, programmer ]filename.type/switches 


The following section discusses only the /switch element in the RSTS/E file 
specification. See Chapter 1 for a description of the other elements of specifying 
files. 


NOTE 


The traditional RSTS/E file specification switches /MODE, /SIZE, 
and /RONLY cannot be used in DCL. Many of the same features are 
available through DCL, but you must use DCL notation. 
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B.2.1 RSTS/E File Specification Switch 


A file specification switch may be included as the final element of the specification 
string. You may specify the following switch options: 


e /PROTECT — protection to be given to the file 
e /FILESIZE — disk size (in blocks) to which the file is pre-extended 


¢ /CLUSTERSIZE — minimum number of contiguous disk blocks forming a 
cluster 


e /POSITION — specific block number on disk at which the file is to be placed 


e /MODE — read/write mode in which the file’s data is passed to the device 
driver 


e /RONLY — read-only mode value for a disk file 


If a file specification switch is not at the end of the file specification, 1s missing a 
colon, or is not a valid form, the system prints the error message ?Illegal switch 
usage. For example, either of the following specifications will produce the switch 
usage error message: 


e ABC/SI:100 [1,2] 
e ABC/SI 


If an argument is missing, or contains an illegal character, the system generates 
an ?Illegal number error message. 


B.2.2 /PROTECT Switch 


The /PROTECT switch establishes a protection code for the file. The /PROTECT 
switch consists of: 


e A slash (/) 
¢ PROTECT (or a minimum abbreviation of PR) 
e <A colon (:) 


e A number specifying the protection code. Use a number sign (#) before octal 
numbers, and a decimal point (.) to terminate decimal numbers. 


The protection code is a string of one to three digits. This string determines 
the file’s degree of protection on two levels: the actions — reading, writing, and 
deleting — against which it is protected, and the user or class of users against 
whom it is protected. 


See Chapter 3 for a complete description of how to specify protection codes. 


B.2.3 /FILESIZE Switch 


The /FILESIZE switch allows the creation of a disk file of the specified size, 
in blocks, before any read/write operations are performed. Thus, /FILESIZE 


reserves space on the disk for data to be placed in the file. This switch consists 
of: 


e A slash (/) 
e FILESIZE or SIZE (or a minimum abbreviation of FI or SI) 
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e A colon (:) 
e An optional number sign (#) for octal conversion of the argument n 


¢ The argument n, a decimal number which indicates the number of blocks in 
the pre-extended file 


e An optional trailing decimal point (.) to ensure that n is interpreted as a 
decimal number. 


The argument n specifies the length in disk blocks to which the file is pre- 
extended. That is, it reserves a specified portion of disk space for the file. The 
value of the /FILESIZE argument is dependent on the type of file. If the file’s 
protection marks it as executable, the argument n must be in the range of 0 to 
65535. If the capability to create large files is present on your system and the file 
is not marked as executable, the argument n can be in the range of 0 to 2*23-1 
(assuming that the disk is large enough). Note that you cannot run an executable 
file that is larger than 65535 blocks. An attempt to pre-extend such a file beyond 
block 65535 returns a ?Protection violation error message. 


The /FILESIZE switch may be minimally abbreviated to /FI or to /SI. The 
following list shows its valid forms: 


/FI-[#]n[.] 
/FIL:[#]n{.] 
/FILE:[#]n(.] 


/FILESIZE:[#]nL.] 
or 


/SI:([#]n{.] 


/SIZE[# nL] 


B.2.4 /CLUSTERSIZE Switch 


The /CLUSTERSIZE switch establishes the minimum cluster size for a disk 
file; a cluster is a number of contiguous blocks taken together as a unit. The 
/CLUSTERSIZE switch is especially useful for large files; specifying a large 
cluster size speeds up random access to the data and prevents such files from 
crowding or filling your directory, whose size is limited. RSTS/E permits cluster 
sizes of 1, 2, 4, 8, 16, 32, 64, 128, or 256 blocks. 


The /CLUSTERSIZE switch consists of: 

e A slash (/) 

¢ CLUSTERSIZE (or a minimum abbreviation of CL) 
¢ Acolon (:) 


e An optional minus sign (-) to specify a negative cluster size (see the next 
paragraph) 
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e An optional number sign (#) for octal interpretation of the argument n 
e The argument n specifying the cluster size in blocks 


e A decimal point (.) to ensure decimal interpretation of n 


The following list shows the valid forms of the option: 


/CL:[-][#]n{. ] 
/CLU_[-][#]nf.] 
/CLUS:[-]#]nL.] 


/CLUSTERSIZE‘(-I[#In1.] 


Specifying a negative cluster size avoids certain errors associated with disk 
devices. A negative cluster size causes the system to use the absolute value of 
the cluster size, if the device on which the file is created allows that value. If 
the absolute value is less than the device cluster size at which the file is to be 
created, the system uses the device cluster size instead of returning an error. 


B.2.5 /POSITION Switch 


The /POSITION switch allows you to specify the location of a file on disk. The 
/POSITION switch consists of: 


e A slash (/) 
e POSITION (or a minimum abbreviation of PO) 
e A colon (:) 


e The argument n, a decimal number that specifies the desired placement of 
the file 


The argument n indicates a device cluster number on the disk. The device cluster 
numbers vary from disk to disk; see the RST'S/E System Generation Manual for 
a table of device sizes. 


If the value of n in /POSITION:n is 0, no placement is performed and the system 
determines the location of the file on the disk. If the value of n is a nonzero 
number, the system attempts to place the first block of the file at the specified 
device cluster number on the disk. If the file cannot be placed at that location, 
the system places the first block of the file at the first free cluster number that is 
greater than the specification. 


When a file is placed, it is marked as such by the monitor. Note that no error 

is returned if the system is unable to place the file at the specified location. To 
determine the actual location of the file on disk, use the /PO,/FU, or /S options of 
the DIRECT program. For example: 


SY: [2,211] 


RMSTST.B2S 18698 
RMSTST.OBJ 18720 
RMSTST .MAP 18723 
CHTST .BAS 6020 
CHTSTi.T Sh 16562 
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The following list shows the valid forms of the POSITION option: 


/PO:n 
/POS:n 
/POSI:n 


/POSITION:n 


Note that the position of a file on disk may change if you backup and restore the 
file with the BACKUP program. 


B.2.6 /MODE and /RONLY Switches 


The /MODE switch enables the passing of up to 16 (decimal) bits of information 
to the device driver at file open time. The meaning of these bits (if any) is 
device dependent, and determines the read/write mode for data transfer. For 
explanations of the bits, see the RSTS/E Programming Manual. 


The /MODE switch consists of: 

e A slash (/) 

e MODE (or a minimum abbreviation of MO) 

e A colon (:) 

e An optional number sign (#) for octal interpretation of the argument n 


e The argument n specifying a mode setting between 0 and 32767 (decimal) 
inclusive 


e An optional decimal point (.) to ensure decimal interpretation of n 


The following list shows the valid forms of the option: 


/MO:[#]n[.] 
/MOD:[#]n[.] 
/MODE:[#]n[.] 


The /RONLY switch enables setting of the read-only MODE value for a disk file. 
The /RONLY switch consists of: 


e =6A slash (/) 
e RONLY (or a minimum abbreviation of RO) 


The following list shows the valid forms of the option: 


/RO 
/RON 
/RONL 
/RONLY 
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GLOSSARY 


Absolute Time 


A specific date or time provided in a command line. (Compare with Real 
Time.) 


Account 


What you log in to with a Project-Programmer Number (PPN) and a password 
on a RSTS/E system. 


Account Number 


A number that identifies the project group and the programmer. It is also 
known as the Project-Programmer Number (PPN, such as [3,25]). You need 
an account number (which new users receive from the system manager) to 
log in to the system. The system uses the account to charge you for computer 
time and arrange, find, and protect your stored files. 


Alphanumeric 


A contraction of alphabetic-numeric; the set of characters that compose text. 
Characters include letters and numerals, and exclude special characters. 


ANSI 


American National Standards Institute. Creates standards to ensure 
consistency in all aspects of computer technology: command languages, 
keyboards, codes, and so forth. 


ASCIil 


American Standard Code for Information Interchange, a standard 7-bit code 
representing the 128 characters in which textual information is recorded. 


Batch Processing 


A way of scheduling programs that allows you to enter jobs to be run without 
your input at a terminal. Batch processing can be used, for example, in data 
processing operations that need no interaction. 


Baud Rate 
The speed at which information is transferred between devices on a system. 


Bit 
A contraction of "binary digit." A bit is the smallest unit of information in a 
binary system of notation. 


Block 


A set of consecutive machine words, characters, or digits handled as a unit, 
particularly in input and output operations. On the RSTS/E system, a block 
is equal to 256 16-bit words or 512 8-bit bytes. 
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BPI 


Bits per inch; a measure of tape density. Common densities for magnetic 
tapes are 800, 1600, 6250, 6667, 8000, and 10000 bpi. 


Buffer 


A temporary storage area used to contain data. Buffers hold data being 
passed between processes or devices that operate at different speeds or 
times. 


Byte 
A group of eight binary digits (bits) processed as a unit. Each ASCII 
character is stored in one byte. 


CCL 
See Concise Command Language. 


Central Processing Unit (CPU) 


The portion of a computer system that controls the interpretation and 
execution of instructions. 


Channel 


A logical concept that helps you manage the flow of data to and from a 
running program. 


Character 
An element in a set of symbols. A human-readable symbol can be a letter 
from A to Z, a number from 0 to 9, or a special symbol. A machine intelligible 
symbol is made of a group of binary digits. Some machine-readable symbols 
are "nonprinting” characters (such as tabs or control characters), because they 
cannot be displayed on a line printer listing or a video screen. 


Cluster Size 


The unit of size in which files are allocated. Cluster size is measured in 
blocks. 


Command 
A user-initiated order to a computer system that causes the performance of a 
predefined operation. A command is the part of an instruction that specifies 
the operation to be performed. 


Command environment 


An interface through which you can communicate with the computer. DCL 
and BASIC-PLUS are examples of command environments. 


Command level 


The part of a session at a terminal when the system awaits your input. For 
example, you can recognize DCL command level by its dollar sign ($) prompt. 


Command line/command string 


A line (or set of continued lines), normally terminated by pressing the 
RETURN key. A command line or string contains a command and (optionally) 
information modifying the command. The full form of the command string 
contains a command, its qualifiers, and its parameters (file specifications, for 
example) and their qualifiers. 


Command line editing 
Allows you to edit with the following line functions: 


Move the cursor left or right one character 

Move the cursor to the beginning or end of the line 

Delete the previous word 

Delete to the beginning of the line 

Insert a new character at the cursor position 

Overstrike (replace) an existing character at the cursor position 


Command line recall 


Allows you to recall your most recently entered commands or program input 
lines. 


Compile 
To translate a source program (one written by a user) into machine language. 


Concatenate 
To unite in a series; to link together many items into one. 


Concise Command Language (CCL) 


A way to call a system program and provide it with input on a single 
command line. Many system programs (such as PIP on RSTS/E), use the 
name of the program as the command name, followed by the command line 
required by that program. CCLs can be different for each RSTS/E system. 


CPU 
See Central Processing Unit. 


Crash 


An unexpected computer system shut-down, caused by problems such as 
power failures. 


Creation date 
The date on which a file on RSTS/E is created or updated. 


CRT 


Cathode Ray Tube. A CRT is used in video display terminals, such as VT220s 
and VT100s. Sometimes video terminals are called "CRT devices." 


CTRL (control key) 


The keyboard character that causes a control action. It is used in combination 
with an alphabetic key. For example, if you hold down the control key and 
press the "U" key on a RSTS/E system, the system responds by deleting 
characters from the cursor to the beginning of the line. 


DECnet 
A family of hardware/software products that creates distributed networks 
from Digital computers and their interconnecting devices. DECnet allows you 
to do such operations as copying files from one computer (node) to another, 
and connecting your terminal to a remote computer. 


Default 


To omit information in a computer operation and let the computer make 
a predefined assumption about the operation; the assumption made by a 
program when you do not provide a value. 
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Density 
The number of bits per inch (bpi) that can be stored on a magnetic tape. 


Device 
A peripheral hardware unit used to perform input and output operations. 


Dialup Line 
A communications circuit that connects a terminal and a computer over a 
telephone line. 


Digital Command Language (DCL) 
The default command language on RSTS/E systems. 


Disk 
A mass storage device that holds data on rotating magnetic platters. 


Disk Quota 


The capacity of a disk to store information. Each user of a computer system 
is allowed a finite amount of storage space. On RSTS/E, the system notifies 
you if you try to exceed your disk quota. 


Display 
The printing of text at a hardcopy terminal, or the output of text at a video 
screen. 


DOS 
Disk Operating System. DOS is used primarily to refer to a tape format. 


Echo 


The display of characters you type at a terminal. When you log in to a 
RSTS/E system, for example, generally the PPN is echoed, but the password 
is not.. 


Echo on read 


The processing and echoing of characters typed on a terminal only when a 
read occurs. 


Editing Session 
The time you spend at a terminal using a text editor. 


Editor 
A program that allows you to modify data, programs, or files. 


Elapsed Time 
The amount of time you are logged in to a computer system. 


Error Message 


A notice from the computer that indicates an error and usually contains 
recovery information; a program message indicating the presence of a 
mistake. For example, RSTS/E displays an error message if you type in data 
that it cannot process. 


Field 
One or more characters treated as a unit; a specified area of a record used for 
a single type of data. For example, a file name is occasionally referred to as 
the "name field" of a complete file specification. 


File 
An ordered collection of stored text or data; a collection of related information. 
For example, you could create files on RSTS/E to contain data for a program 
or text for a report. 


File Specification 


The name used to identify the node, device, directory name, file name, and 
file type under which you store a file. 


File Type 
The part of a file specification that follows the file name. A file type 
(sometimes called an "extension" on RSTS/E) consists of a period (.) followed 
by up to three alphanumeric characters. 


Hard copy 


Computer output printed on paper, such as from a line printer or a hardcopy 
terminal. 


Hardware 


The physical equipment or machinery of a computer system. Devices are 
examples of hardware. (Compare with Software. ) 


Help Facility 
A set of online messages that describes the functions of available programs on 
a system. 


Host 


The computer system that processes your commands and responds to them. 
The network node that you are currently logged in to. 


Input 
Information that is transmitted to a computer; information to be processed 
by the computer; a device involved in gathering data. For example, when 
you type in a program at a terminal that is connected to the computer, you 
are providing input. Among other things, the terminal is serving as an input 
device. 


Insert mode 


Indicates that each new character should be inserted at the current cursor 
position; characters to the right of the cursor are shifted right one character 
to make room for the new character. 


Installation 


The location of a computer system. For example, this manual refers to your 
installation as the computer system at your site. 


Interactive 


The process of communication between a person and a computer system. For 
example, the computer prompts you for input and you type in a response. 


Interface 


A shared boundary between two elements of a computer system, such as 
between two programs or devices. 


Job 


Everything a user does from beginning to end of a terminal session, for 
example, commands, programs, processing, or output. 
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Job Header 


An area of memory where each job on the system is assigned its own set of 
recall buffers 


Job Number 


The number RSTS/E assigns to your job when you log in. Your job number is 
deleted when you logout. 


Journaling 


The recording of user input during an editing session. For example, if you 
edit a file using EDT and the system crashes, journaling allows you to recover 
your work when the system resumes operation. 


Keyboard 


The set of keys that you use to type at a terminal to provide input to the 
computer. 


Keyboard Monitor 


A part of the system software that provides communication between a person 
at a keyboard and the operating system. The keyboard monitor interprets the 
commands you type at the keyboard. 


Keyword 
A word that is an integral part of a command or qualifier. 


LAT 


The abbreviation for local area transport; LAT is a communications protocol 
used in a local area network. 


Link 
To combine or connect two independent entities; a reference to another 
element in a set of elements. Linking is generally used to mean combining 
two or more object files into an executable file. 


Literal 


Characters that are interpreted literally. For example, in BASIC-PLUS 
programming, you can enclose a character string in quotation marks so that 
the characters are used as literals. 


Local Node 


The node a user first logs in to on the system. The local node is generally 
used in discussions of network operations. (Compare with Remote Node. ) 


Logical Name 


A name that a user or system manager can assign to a physical device or to a 
PPN. (Compare with Physical Name.) 


Log In 
The process of gaining access to a computer system. 


Log Out 
The process of ending a session with the computer. 


Longest Record Length (LRL) 


Is dependent on the record format. For variable-length and stream records, 
the size of the largest record inserted in that file is the longest record length. 
For fixed-length records, the longest record length is the same for every 
record in the file. 


Magnetic Tape 
A plastic tape coated with magnetic material on which data is recorded in 
narrow tracks. 


Memory 


Internal computer storage. Memory is also a device on which data can be 
stored and from which it can be accessed. 


Merge 
In files, to join the contents of one file to the contents of another file. 


Mnemonic 
An aid to memory, as in mnemonic file names, where the name of the file 
reminds you of the contents of the file. 


Mode 


A state of being, such as “interactive mode,’ in which the system or a program 
prompts you for your input. 


Multiline commands 
Commands or lines that extend beyond the terminal’s width and wrap onto 
one or more subsequent lines. 


Network 
A set of interconnected computer systems. 


Node 


An individual computer system in a network that can communicate with 
other computer systems in the network. 


Non-File-Structured Device 
A device that does not separate data into distinct files and does not maintain 
directories. 


Null 
An element that is explicitly left blank. For example, a null file type consists 
of no alphanumeric characters. In other words, the file specification includes 
a file type, which is null. 


Operator 
1. The part of an instruction that tells the computer what to do. For example, 
the plus sign (+) is an operator telling the computer to perform addition. 2. A 
person who controls the running or function of a machine or device. 


Operator/Message Services (OMS) 
Receives event information, such as LOGIN attempts or printer offline 
notices, from various system programs and broadcasts the messages to all 


operator terminals. If requested to do so, OMS also saves the messages in its 
log file for later display (via the SHOW REQUESTS command.) 
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Operating System 
Software that controls the execution of computer programs and performs 
system functions. An operating system is an integrated collection of programs 
that supervise computer operations. 


Operator Terminals 
Terminals designated to receive operator messages or requests or both. 


Output 
The device involved in transferring data from memory; the data created as 
the result of transfer; processed data. For example, when your terminal 
displays the contents of a file, the terminal serves as an output device. 


overstrike mode 


Indicates that each new character should replace (overstrike) the character 
positioned at the cursor. 


Parameter 


The object of a command. A parameter can be a file specification or a keyword 
option. 


Parity Bit 
A binary digit appended to a group of bits to make the sum of all the bits 
always odd (odd parity) or always even (even parity). (Parity pertains to the 
way data is transmitted between the system and its devices.) A parity bit is 
used to verify data storage. 


Password 


The character string assigned to each user that verifies user access privileges 
to a system; a way of assuring file confidentiality on time-sharing systems. 
You need a PPN and a password to log in to a RSTS/E system. 


PBS 


The Print/Batch Services package which provides several important services 
for RSTS/E users and system managers. The major components of PBS are: 


Queue Manager accepts all user requests, controls all print and batch 
queues, schedules jobs to run, and creates new jobs as needed to process 
requests. 

Print Servers process print requests on selected printers. Both line 
printers (LP) and terminals (KB) can be handled by print servers. 

Batch Servers control execution of submitted command procedures, using 
the DCL command file processor. 

User Interface is how an application program communicates with PBS. 


Physical Name 


A name for a peripheral device; identifies the drive, control circuit, and 
medium together. (Compare with Logical Name.) 


Port 


A device that passes messages between the monitor and one or more 
terminals. 


Priority | 
The level of importance assigned to an operation in computing. For example, 
you can set the priority of a print request so that your job is printed before or 
after other jobs in the print queue. 


Programming 


The process of planning, writing, testing, and correcting the steps required 
for a computer to solve a problem or perform a desired operation. 


Project-Programmer Number (PPN) 
See Account Number. 


Prompt 
A symbol indicating that the system is prepared for input from a user. 


Protection Code 
A feature that allows you to decide who can have access to your files. 


Pseudo Keyboard 
A part of RSTS/E software, primarily used in batch jobs. The pseudo 
keyboard operates like a real terminal, except that the "typist" is a program 
rather than a person. 


Qualifier 
A command language keyword that modifies the operation of a command. 
Qualifiers are always preceded by slash (/) characters. (On some systems, a 
qualifier is called a "switch.") 


Queue 
A line-up of jobs to be performed in sequence, as in a batch or print queue, in 
which certain jobs are given priority over others. 


Read 
A process that performs input from a file or a device. 


Read-Only 
The state a device or file is in when it can be used for input but not for 
output. (Same as Write-Locked.) 


Real Time 


Synonym for time as we know it, in 24-hour days. (Compare with Absolute 
Time.) 


Remote Node 
Any node in the network other than the local node. In other words, a remote 


node is any node except the one you originally logged in to. (Compare with 
Local Node.) 


RSTS/E 
An acronym for Resource-Sharing Timesharing System/Extended, a Digital 
operating system. 


Run Burst 
The length of time, measured in ticks, that a job is allowed to run 
uninterrupted in the CPU of a computer. 


Run Time 


The time in which a program is executed. Run time is the actual amount of 
CPU time required for a program to complete execution. 
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Run-Time System 
System software that manages a programming language. The number of 
run-time systems can differ from one system to another. 


Software 
The set of programs that controls the operation of a computer system. 


SPR 


Software Performance Report. Submitted by a user (generally the system 
manager) to report a possible problem in the software. 


Swapping 
The transfer of a job from memory to disk or vice versa. Lets the system run 
more jobs than its memory can hold at once. 


Switch 
See Qualifier. 


Syntax 
The rules governing the structure of statements in a computer language; the 
structure of a language. 


System 
A combination of hardware and software that performs processing operations; 
a collection of components that forms a functional unit. 
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System Manager 
The person or group of people who schedule the access and use of a computer 
system. 


Temporary File 
A file that is deleted from your account when you logout. 


Terminal 


A device, consisting of a keyboard and display mechanism, used to enter and 
receive data to and from a computer. LA120s (hardcopy) and VT100s (video) 
are examples of terminals. 


Terminal Server 


A system part that connects terminals to services on nodes in a local area 
network; users have the same capability that they would have if they were 
connected to the node by direct lines. 


Tick 
A fraction of a time slice. A tick is about 1/60 of a second. 


Timesharing 
A method of computer operation in which more than one user shares the 
system at the same time. The central theory of timesharing is that the 
system processes each user’s job in slices of time, so rapidly that the user is 
often unaware that processing time is shared. 


Time Slice 


The amount of time (in fractions of a second) that the computer assigns to 
each user’s job during timesharing. 


Translator 


Software that converts human-readable programs into machine-readable 
code. 


Typeahead characters 
Characters that are processed and echoed as soon as you type them, even if 
no read is pending. 


Utility 
A program or set of programs that performs a set of commonly used functions, 
such as copying or deleting files. The PIP program and the EDT editor are 
examples of utilities on RSTS/E. 


Wildcard 


A symbol that allows you to refer to more than one file with a single file 
specification. The asterisk (*) is a commonly used wildcard symbol in DCL, as 
in *.DAT to specify all names of data files. 


Word 
A unit of storage in the computer. A word holds 16 bits, or two ASCII 
characters, of information. 


Write 
A process that performs output to a file or a device. 
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Abbreviations 


in SHOW DEVICE/ALLOCATED display, 6—17t 


in SHOW DISKS display, 6—17t 

in system status display, 4—4t 
Account 

using, 1-1 to 1-25 
/ACCOUNTING_DATA qualifier 


SHOW ACCOUNT command, 4—14 


Account number, 1-19 
/ADVANCED_VIDEO qualifier 

SET TERMINAL command, 5—5 
/AFTER=date:time qualifier 

PRINT command, 7-3 

SET ENTRY command, 7-14 

SUBMIT command, 7-7 
/AFTER qualifier, 2-11 
ALLOCATE command, 6—8 


Allocating common area space, 8—-42fg 


/ALLOCATION=n qualifier 
COPY command, 3-25 
CREATE command, 3-2 
/ALLOCATION qualifier 
MERGE command, 3-63 
SORT command, 3-57 
/ALL qualifier 
DELETE/ENTRY command, 7-17 
RECALL command, 1-16 
SET ENTRY command, 7-14 
SHOW/PORT command, 4—12 
SHOW ENTRY command, 7-10 
SHOW JOB command, 4—9 
SHOW QUEUE command, 7-18 
SHOW TERMINAL command, 5-2 
SHOW USER command, 4-8 
/ALT_MODE qualifier 
SET TERMINAL command, 5—5 
ANSI format, 6—6 
/ANS|_FORMAT qualifier 
COBOL command, 8-14 
APPEND command, 3-36 to 3-38 
/BEFORE=date qualifier, 3-37 
/CONFIRM qualifier, 3-37 
/CREATED qualifier, 3-37 
/LOG qualifier, 3-37 
/MODIFIED qualifier, 3-37 
/QUERY qualifier, 3-37 
/SELECT=SIZE qualifier, 3-37 
/SINCE=date qualifier, 3-37 
/APPEND qualifier 
OPEN/LOG_FILE command, 5—12 


/APPLICATION qualifier 
SHOW/PORT command, 4—12 
Arguments 
abbreviating, 2-6 
entering, 2-8 
ASSIGN command, 6—20 
Attached jobs, 4-6 
/ATTACHED qualifier 
SHOW JOB command, 4-9 
SHOW USER command, 4-8 


B 


BACKSPACE, 1-18 
BACKUP/DIRECTORY command 
/OCCURRENCE qualifier, 3-46 
Backup command, 3-39 
BACKUP command 
/CREATED qualifier, 3-40 
/END qualifier, 3-40 
/EXCLUDE qualifier, 3-40 
/INCLUDE qualifier, 3-41 
/INITIALIZE qualifier, 3-41 
/IN_LABEL qualifier, 3-41 
/LIST_FILE qualifier, 3-41 
/MODIFIED qualifier, 3-40 
/OUT_LABEL qualifier, 3-41 
/PROMPT qualifier, 3-42 
/QUERY qualifier, 3-42 
/REWIND qualifier, 3-42 
/VERIFY qualifier, 3-43 
/BACKUP qualifier 
SET FILE command, 3-77 
BASIC command, 8—7 
/BP2 qualifier, 8—7 
/BPLUS qualifier, 8—7 
BASIC-PLUS 
command environment, 1-8 
commands, B—2t 
BASIC programming, 8—7 
/BATCH qualifier 
DELETE/ENTRY command, 7-17 
SET ENTRY command, 7-14 
SHOW ENTRY command, 7-10 
SHOW QUEUE command, 7-18 
/BEFORE=date qualifier 
APPEND command, 3—37 
COPY command, 3-25 
DELETE command, 3-19 
DIRECTORY command, 3—9 
RENAME command, 3-32 


Index 
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/BEFORE=date qualifier (Cont.) 
SET PROTECTION command, 3—74 
TYPE command, 3-16 
/BEFORE qualifier, 2-11 
/BLOCK_SIZE=n qualifier 
COPY command, 3-25 
/BP2 qualifier 
BASIC command, 8—7 
/BPLUS qualifier 
BASIC command, 8—7 
/BREAK qualifier 
SET TERMINAL command, 5—5 
/BRIEF qualifier 
DIRECTORY command, 3-9 
RESTORE/DIRECTORY command, 3—54 
SHOW ACCOUNT command, 4-14 
SHOW ENTRY command, 7—10 
SHOW QUEUE command, 7-18 
SHOW TERMINAL command, 5-2 
/BROADCAST qualifier 
SET TERMINAL command, 5—5 
/BUCKET_SIZE qualifier 
MERGE command, 3-63 
SORT command, 3—57 
BYE command, 1—12 to 1-13 


C 


/C81 qualifier 

COBOL command, 8-14 
/CACHE qualifier 

SET FILE command, 3-77 
Call structure outline, 8—39fg 
CC command, 8-8 

/DEFINE qualifier, 8—8 


/ENVIRONMENT=({[NO]JFPU, [NO]PIC) qualifier, 


8-8 


/[NOJERROR_LIMIT|=qualifier] qualifier, 8-8 
/[NOJINCLUDE_DIRECTORY=(pathname [....]) 


qualifier, 8-8 
/[NOJLIST[=file-spec] qualifier, 8—8 
/[NOJMACRO[=file-spec] qualifier, 8—8 
/[NOJMEMORY|[=qualifier] qualifier, 8-8 
/[NOJMODULE qualifier, 8-8 
/[NOJOBJECT[=file-spec] qualifier, 8-8 


/[NO]STANDARDJ=(option,...)] qualifier, 8-8 
/[NOJTERMINAL[=[NO]SOURCE] qualifier, 8-8 


/[NO|TITLE=(identifier) qualifier, 8-8 


/[NOJUNDEFINE=(identifier[,...]) qualifier, 8-8 
/[NO]WARNINGS[=(option,...)] qualifier, 8-8 


/[NOJWORK_FILE qualifier, 8-8 

/SHOW|[=option,...] qualifier, 8-8 
CC Programming, 8-8 
/CHECK=BOUNDS qualifier 

COBOL command, 8—14 
/CHECK=PERFORM qualifier 

COBOL command, 8-14 
/CHECK qualifier 

COBOL command, 8-14 

FORTRAN/F77 command, 8—22 
/CHECK_SEQUENCE qualifier 

MERGE command, 3-63 
CLOSE/LOG_FILE command, 5-14 
/CLUSTERSIZE switch, B-8 
/CLUSTER_SIZE=n qualifier 

COPY command, 3—25 

CREATE command, 3-2 
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COBOL-81 programming, 8—14 
COBOL command, 8—14 
/ANSI_FORMAT qualifier, 8-14 
/C81 qualifier, 8-14 
/CHECK=BOUNDS qualifier, 8-14 
/CHECK=PERFORM agualifier, 8-14 
/CHECK qualifier, 8-14 
/CODE=CIS qualifier, 8-14 
/CROSS_REFERENCE qualifier, 8-14 
/DEBUG qualifier, 8-14 
/DIAGNOSTICS qualifier, 8-14 
/LIST qualifier, 8—14 
/MAP qualifier, 8-14 
/NAMES=aa qualifier, 8-14 
/NODIAGNOSTICS qualifier, 8-14 
/NOLIST qualifier, 8-14 
/NOOBJECT qualifier, 8-14 
/NOOPTIMIZE qualifier, 8-14 
/NOSTANDARD=option qualifier, 8-14 
/OBJECT qualifier, 8-14 
/OPTIMIZE qualifier, 8-14 
/SHOW=MAP qualifier, 8-14 
/SHOW qualifier, 8-14 
/STANDARD=option qualifier, 8-14 
/SUBPROGRAM qualifier, 8-14 
‘TEMPORARY =device qualifier, 8-14 
/WARNINGS qualifier, 8-14 
/CODE=CIS qualifier 
COBOL command, 8—14 
/CODE qualifier 
FORTRAN/FOR command, 8-25 
/COLLATING_SEQUENCE qualifier 
MERGE command, 3-63 
SORT command, 3—57 
/132_COLUMNS qualifier 
SET TERMINAL command, 5—5 
@ command, 2-15 
Command 
RECALL, 1-14 
/COMMANDs=file-spec qualifier 
EDIT command, 3—5 
Command environments, 1—8 
BASIC-PLUS, B-1 
DCL, B-1 
RSX, B-1 
RT11, B-1 
Command files 
see command procedures 
Command line editing, 1-18 
echo on read, 1—9 
keys, 1-18 
SET HOST, 1-29 
Command Line Editing, 1-14 
Command procedures, 2-13 to 2-15 
Login, 1-9 to 1-10 
Command recall 
echo on read, 1-9 
keys, 1-18 
SET HOST, 1-29 
Command Recall, 1-14 
Commands 
abbreviating, 2-6 
ALLOCATE, 6-8 
APPEND, 3-86 to 3-38 
ASSIGN, 6—20 
BACKUP, 3-39 
BASIC, 8-7 


Commands (Cont.) 


BASIC-PLUS, B—2t 

BYE, 1-12 to 1-13 

CC, 8-8 
CLOSE/LOG_FILE, 5-14 
COBOL, 8-14 

continuing on more than one line, 2-4 
COPY, 3-23 to 3-31 
CREATE, 3-2 to 3-4 
DEALLOCATE, 6—10 
DEASSIGN, 6-23 
DELETE, 3-19 to 3-22 
DELETE/ENTRY, 7-17 
DIBOL, 8-19 
DIFFERENCES, 3-68 to 3-70 
DIRECTORY, 3-9 to 3-15 
DISMOUNT, 6—16 

EDIT, 3-5 to 3-8 
entering, 2-4 

entering qualifiers, 2-7 

for file operations, 3—1t 
format description, 2—2fg 
formats, 2-1 to 2-13 
FORTRAN, 8—21 

HELLO, 1-6 

HELP, 1-10 to 1-12 
INITIALIZE, 6-14 

LINK, 8-30 to 8-46 
LOGIN, 1-6 

LOGOUT, 1-12 to 1-13 
MACRO, 8-28 

MERGE, 3-62 to 3-67 
MOUNT, 6—11 
OPEN/LOG_FILE, 5—11 
PRINT, 7-3 

program development, 8—1t 
qualifier defaults, 2-7 
RECALL, 1-16 

RENAME, 3-32 to 3-35 
REQUEST, 4-20 

RSX, B-6t 

RT11, B—3t 

RUN, 8-47 

SET, 4-16 to 4-19 
SET/LOG_FILE, 5-15 
SET ENTRY, 7-14 

SET FILE, 3-77 

SET HOST, 1-28 

SET PASSWORD, 4-17 
SET PROMPT, 4—19 

SET TERMINAL, 5-4 to 5-10 
SHOW, 4-1 to 4-15 
SHOW ACCOUNT, 4-14 
SHOW DEVICE, 6-17 
SHOW DEVICE/ALLOCATED, 6—17 
SHOW DISKS, 6-17 
SHOW ENTRY, 7-10 
SHOW JOB, 4-9 

SHOW NETWORK, 1-28 
SHOW PORT, 4-11 
SHOW QUEUE, 7-18 
SHOW SYSTEM, 4-13 
SHOW TERMINAL, 5-2 
SHOW USER, 4-8 

SORT, 3-56 to 3-61 
SUBMIT, 7-7 

terms used in formats, 2—2t 


Commands (Cont.) 


TYPE, 3-16 to 3-18 
using qualifiers, 1-13 
Comments 
entering, 2-5 
Compiling programs, 8-3 
/CONFIRM qualifier 
APPEND command, 3-37 
COPY command, 3-25 
DELETE command, 3-19 
RENAME command, 3-32 


SET PROTECTION command, 3-74 


TYPE command, 3-16 
/CONTIGUOUS qualifier 
COPY command, 3-25 
CREATE command, 3-2 
MERGE command, 3—63 
SORT command, 3—57 
Continuation character, 2-4 
/CONTINUATIONS=n qualifier 
FORTRAN/F77 command, 8—22 
Control keys 
CTRL/C, 3-16 
CTRL/O, 3-16 
Ctr/Q, 1-6 
CTRL/Q, 3-16 
CTRL/S, 1-6, 3-16 
Ctri/U, 1-3 
/CONTROL qualifier 
SET TERMINAL command, 5—5 
/CONVERT qualifier 
PRINT command, 7-3 
/COPIES=n qualifier 
PRINT command, 7-3 
COPY command, 3-23 to 3-31 
/ALLOCATION=n qualifier, 3-25 
/BEFORE=date qualifier, 3-25 
/BLOCK_SIZE=n qualifier, 3-25 
/CLUSTER_SIZE=n qualifier, 3-25 
/CONFIRM qualifier, 3-25 
/CONTIGUOUS qualifier, 3-25 
/CREATED qualifier, 3-25 
/MODIFIED qualifier, 3-25 
/OVERLAY qualifier, 3-25 
/POSITION qualifier, 3-25 
/PROTECTION=n qualifier, 3-25 
/QUERY qualifier, 3-25 
/REPLACE qualifier, 3-25 
/RETAIN_DATES qualifier, 3-25 
/SELECT=SIZE qualifier, 3-25 
/SINCE=date qualifier, 3-25 
/CPU_LIMIT=n qualifier 
SET ENTRY command, 7-14 
SUBMIT command, 7-7 
CREATE command, 3-2 to 34 
/ALLOCATION=n qualifier, 3-2 
/CLUSTER_SIZE=n qualifier, 3-2 
/CONTIGUOUS qualifier, 3-2 
/POSITION qualifier, 3-2 
/PROTECTION=n qualifier, 3-2 
/REPLACE qualifier, 3-2 
/CREATED qualifier 
APPEND command, 3-37 
BACKUP command, 3—40 
COPY command, 3-25 
DELETE command, 3-19 
DIRECTORY command, 3-9 
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/CREATED qualifier (Cont.) 


RENAME command, 3-82 
RESTORE/DIRECTORY command, 3—54 
RESTORE command, 3—48 
TYPE command, 3-16 
/CREATE qualifier 
EDIT command, 3-5 
/CREFILL qualifier 
SET TERMINAL command, 5—5 
/CROSS_REFERENCE qualifier 
COBOL command, 8-14 
CtrvVA, 1-18 
CtrvB, 1-18 
CTRL/C key, 3-16 
Ctr/D, 1-18 
CtrVE, 1-18 
Ctr/VF, 1-18 
CtrVH, 1-18 
Ctr/J, 1-18 
CtrVN, 1-18 
CTRL/Q key, 3-16 
CtrvR, 1-18 
CTRL/S key, 3-16 
CTRL key, 4-10 
to show job status, 4-10 
CtrvU, 1-18 
Ctrlkeys 


see control keys 
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Date and time formats, 2—11 
absolute, 2-11 
relative, 2-13 
/DATE qualifier 
DIRECTORY command, 3-9 
Dates 
format for entering, 2-11 
DCL 
default keyboard monitor, 1-8 
using command qualifiers, 1-13 
DCL command descriptions 
RESTORE, 3-52 
DEALLOCATE command, 6—10 
DEASSIGN command, 6—23 
/DEBUG qualifier 
COBOL command, 8-14 
DIBOL command, 8—19 
DECnevE 
using, 1-26 to 1-29 
Default 
keyboard monitor, 1-8 
/DEFAULT qualifier 
SET PROTECTION command, 3-74 
/DEFINE qualifier 
CC Command, 8-8 
/DELETABLE qualifier 
SET FILE command, 3-77 
DELETE/ENTRY command, 7-17 
/ALL qualifier, 7-17 
/BATCH qualifier, 7-17 
/PRINT qualifier, 7—17 
DELETE command, 3-19 to 3-22 
/BEFORE=date qualifier, 3-19 
/CONFIRM qualifier, 3-19 
/CREATED qualifier, 3-19 
/ERASE qualifier, 3-19 
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DELETE command (Cont.) 


/LOG qualifier, 3-19 
/MODIFIED qualifier, 3-19 
/QUERY qualifier, 3-19 
/SELECT=SIZE qualifier, 3-19 
/SINCE=date qualifier, 3-19 
/WARNINGS qualifier, 3-19 
DELETE key, 1-4 
/DELETE qualifier 
PRINT command, 7-3 
SUBMIT command, 7-7 
/DELIMITER qualifier 
SET TERMINAL command, 5—5 
/DENSITY=n qualifier 
INITIALIZE command, 6—16 
MOUNT command, 6-11 
Detached jobs, 4-6 
/DETACHED qualifier 
SHOW JOB command, 4-9 
SHOW USER command, 4-8 
Devices 
ALLOCATE command, 6—8 
ASSIGN command, 6—20 
DEALLOCATE command, 6—10 
DEASSIGN command, 6-23 
disks, 6-4 to 6-5 
DISMOUNT command, 6-16 
INITIALIZE command, 6—14 
logical names, 6-18 to 6-23 
magnetic tape, 6-6 to 6-7 
MOUNT command, 6-11 
names, 6—1, 6—2t 
physical, 6-1 to 6-18 
SHOW command, 6—17 
specifying, 6—1 
table of commands, 6—1t 
/DEVICE_TYPE qualifier 
SET TERMINAL command, 5—5 
/DIAGNOSTICS qualifier 
COBOL command, 8—14 
DIBOL-11 programming, 8-19 
DIBOL command, 8-19 
/DEBUG qualifier, 8-19 
/LIST qualifier, 8-19 
/NOLIST qualifier, 8-19 
/NOOBJECT qualifier, 8-19 
/NOWARNINGS qualifier, 8-19 
/OBJECT qualifier, 8-19 
/OPTIMIZE qualifier, 8-19 
/STANDARD qualifier, 8-19 
/WARNINGS qualifier, 8-19 
DIFFERENCES command, 3-68 to 3-70 
/IGNORE=BLANKLINES qualifier, 3-68 
/MATCH=size qualifier, 3-68 
/MAXIMUM_DIFFERENCES=n qualifier, 3-68 
/OUTPUT=file-spec qualifier, 3-68 
Directory, 1-19 
DIRECTORY command, 3-9 to 3-15 
/BEFORE=date qualifier, 3-9 
/BRIEF qualifier, 3-9 
/CREATED qualifier, 3-9 
/DATE qualifier, 3-9 
/FULL qualifier, 3-9 
/MODIFIED qualifier, 3-9 
/NODATE qualifier, 3-9 
/NOSIZE qualifier, 3-9 
/PROTECTION qualifier, 3—9 


DIRECTORY command (Cont.) 


/SELECT=SIZE qualifier, 3—9 
/SINCE=date qualifier, 3—9 
/SIZE qualifier, 3—9 
/TOTAL qualifier, 3-9 
/DISABLE qualifier 
OPEN/LOG_FILE command, 5—12 
SET/LOG_FILE command, 5-15 
Disk quota, 1-25 to 1-26 
Disks, 6-4 to 6—5 
private, 6-5 
public, 6-4 
system, 6-4 
DISMOUNT command, 6—16 
Dollar sign ($) prompt, 1-7 
DOS format, 6—6 
Down Arrow, 1-18 
/DUPLICATES qualifier 
MERGE command, 3-63 
SORT command, 3—57 
/D_LINES qualifier 
FORTRAN/F77 command, 8—22 
FORTRAN/FOR command, 8—25 


E 


Echo on read, 1—9 
EDIT command, 3-5 to 3-8 
/COMMANDs=file-spec qualifier, 3—5 
/CREATE qualifier, 3-5 
/EDT qualifier, 3—5 
/FORMAT=STREAM qualifier, 3—5 
/FORMAT=VARIABLE qualifier, 3—5 
/JOURNAL=[file-spec] qualifier, 3-5 
/NOCOMMAND qualifier, 3-5 
/NOJOURNAL qualifier, 3-5 
/NOOUTPUT qualifier, 3—5 
/OUTPUT=file-spec qualifier, 3-5 
/RECOVER qualifier, 3-5 
Editing 
command line, 1-14 
multiline commands, 1-18 
EDT editor, 3-5 to 3-8 
/EDT qualifier 
EDIT command, 3-5 
/EIGHT_BIT qualifier 
SET TERMINAL command, 5-5 
/EMT_LOGGING qualifier 
SHOW SYSTEM command, 4—13 
/ENABLE qualifier 
OPEN/LOG_FILE command, 5—12 
SET/LOG_FILE command, 5—15 
/END qualifier 
BACKUP command, 3-40 
RESTORE/DIRECTORY command, 3—54 
RESTORE command, 3—49 
Entry 
number, 7-2 
specification, 7-2 
/ENVIRONMENT=([NO]FPU, [NOJ]PIC) qualifier 
CC Command, 8-8 
/ERASE qualifier 
DELETE command, 3—19 
RECALL command, 1—16 
Error messages, A—1 
DCL, A-it to A-28t 
use of ? and % characters, A—1 


/ESCAPE_SEQUENCE qualifier 
SET TERMINAL command, 5—5 
Exclamation point 
as comment character, 2—5 
/EXCLUDE qualifier 
BACKUP command, 3—40 
RESTORE/DIRECTORY command, 3—54 
RESTORE command, 3—49 
Executable file, 8-3 


[= 


Fi2, 1-18 
Fi3, 1-18 
Fi4, 1-18 
/FEED qualifier 
PRINT command, 7—3 
Files 
appending, 3-36 to 3-38 
commands, 3-1t 
comparing, 3-68 to 3—70 
copying, 3-23 to 3-31 
creating, 1-20, 3-2 to 3-8 
deleting, 3-19 to 3-22 
displaying, 1-20, 3-9 to 3-18 
merging, 3-62 to 3-67 
names and types, 1—22 
preallocating, 3-2 
protecting, 3-71 to 3-76 
protection codes, 1—24 
renaming, 3-32 to 3-35 
RSTS types, 1—24t 
sorting, 3-56 to 3-61 
specifying, 1-21 
specifying lists of, 2-6 
specifying RSTS/E, B—6 
using and maintaining, 1-19 to 1-25 
using Wildcards, 1-25 
FILES 
Backup, 3-39 
/FILESIZE switch, B—7 
/FILES qualifier 
SHOW ENTRY command, 7-10 
/FILE_DATA qualifier 
RESTORE command, 3-49 
/FLAG_PAGES qualifier 
PRINT command, 7-3 
/FORMAT=ANSI qualifier 
INITIALIZE command, 6-16 
MOUNT command, 6-11 
/FORMAT=DOS qualifier 
INITIALIZE command, 6—16 
MOUNT command, 6—11 
/FORMAT=FOREIGN qualifier 
MOUNT command, 6—11 
/FORMAT=STREAM qualifier 
EDIT command, 3-5 
/FORMAT=VARIABLE qualifier 
EDIT command, 3—5 
/FORMAT qualifier 
MERGE command, 3-63 
SORT command, 3—57 
/FORMS=form-name qualifier 
PRINT command, 7-3 
SET ENTRY command, 7-14 
/FORM_FEED qualifier 
SET TERMINAL command, 5—5 
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FORTRAN/F77 command 
/CHECK qualifier, 8-22 


/CONTINUATIONS=n qualifier, 8-22 


/D_LINES qualifier, 8-22 

/\4 qualifier, 8-22 
AIDENTIFICATION qualifier, 8-22 
/LIST qualifier, 8-22 
/MACHINE_CODE qualifier, 8-22 
/NOLIST qualifier, 8-22 
/NOOBJECT qualifier, 8—25 
/OBJECT qualifier, 8-22 
/OPTIMIZE qualifier, 8-22 
/STANDARD qualifier, 8-22 


/WARNINGS qualifier, 8-22, 8-25 
/WORK_FILES=n qualifier, 8-22, 8-25 


FORTRAN/FOR command 
/CODE qualifier, 8-25 
/D_LINES qualifier, 8-25 
/l4 qualifier, 8-25 
/LINENUMBERS qualifier, 8-25 
/LIST qualifier, 8-25 
/MACHINE_CODE qualifier, 8-25 
/NOOBJECT qualifier, 8—25 
/OBJECT qualifier, 8-25 
/OPTIMIZE qualifier, 8—25 
/WARNINGS qualifier, 8-25 
FORTRAN commands, 8-21 
FORTRAN programming, 8-21 
/FULL qualifier 
DIRECTORY command, 3—9 


RESTORE/DIRECTORY command, 3-55 
SHOW ACCOUNT command, 4-14 


SHOW ENTRY command, 7-10 
SHOW QUEUE command, 7-18 


SHOW TERMINAL command, 5-2 


Function keys 
see Keys 


H 


/HARDCOPY qualifier 

SET TERMINAL command, 5—5 
HELLO command, 1-6 
HELP command, 1-10 to 1-12 
/HOLD qualifier 

PRINT command, 7-3 

SET ENTRY command, 7-14 

SUBMIT command, 7-7 
/HOST_SYNC qualifier 

SET TERMINAL command, 5—5 
Hyphen 

as continuation character, 2—4 


/\4 qualifier 
FORTRAN/F77 command, 8-22 
FORTRAN/FOR command, 8—25 
/IDENTIFICATION qualifier 
FORTRAN/F77 command, 8—22 
/IGNORE=BLANKLINES qualifier 
DIFFERENCES command, 3-68 
/IGNORE qualifier 
SET FILE command, 3—77 
/INCLUDE qualifier 
BACKUP command, 3-41 
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[INCLUDE qualifier (Cont.) 


RESTORE/DIRECTORY command, 3—55 
RESTORE command, 3-49 


/AINDEXED_SEQUENTIAL qualifier 


MERGE command, 3-63 
SORT command, 3—57 


ANITIALIZE 


Interaction During BACKUP, 3—-41t 


INITIALIZE command, 6-14 


/DENSITY=n qualifier, 6-16 
/FORMAT=ANSI qualifier, 6-16 
/FORMAT=DOS qualifier, 6-16 


ANITIALIZE qualifier 


BACKUP command, 3—41 
RESTORE command, 3-49 


/INQUIRE qualifier 


SET TERMINAL command, 5—5 


/INSERT qualifier 


SET TERMINAL command, 5—5 


[INTERACTIVE qualifier 


SHOW/PORT command, 4-12 


/AIN_LABEL qualifier 


J 


BACKUP command, 3—41 
RESTORE/DIRECTORY command, 3-55 
RESTORE command, 3-49 


Jobs 


attached, 4-6 
detached, 4-6 


/JOB_COUNT=n qualifier 


PRINT command, 7—3 
SET ENTRY command, 7-14 


/JOURNAL=[file-spec] qualifier 


K 


EDIT command, 3—5 


/KATAKANA qualifier 


SET TERMINAL command, 5-5 


Keyboard monitor 


default, 1-8 


/KEY qualifier 


MERGE command, 3—63 
SORT command, 3—57 


Keys, 1—6t 


ALTMODE, 1-6t 
BACKSPACE, 1-18 
Command line editing, 1-18 

BACKSPACE, 1-18 

CtrVA, 1-18 

Ctr/B, 1-18 

Ctri/D, 1-18 

CtrVE, 1-18 

CtrVF, 1-18 

CtrVH, 1-18 

CtrvJ, 1-18 

Ctr/N, 1-18 

CtrVR, 1-18 

CtrVU, 1-18 

Down Arrow, 1-18 

Fi2, i-18 

F13, 1-18 

Fi4, 1-18 

Left Arrow, 1-18 

LINE FEED, 1-18 


Keys 

Command line editing (Cont.) 
Right Arrow, 1-18 
Up Arrow, 1-18 

Command recall, 1-18 
BACKSPACE, 1-18 
Ctri/A, 1-18 
Cirl/B, 1-18 
Ctr/D, 1-18 
Ctr/VE, 1-18 
Ctri/F, 1-18 
Ctrl/H, 1-18 
Ctrl/J, 1-18 
Ctril/N, 1-18 
Ctr/R, 1-18 
Ctr/U, 1-18 
Down Arrow, 1-18 
Fi2, 1-18 
F13, 1-18 
F14, 1-18 
Left Arrow, 1-18 
LINE FEED, 1-18 
Right Arrow, 1-18 
Up Arrow, 1-18 

CTRL/C, 1-6t, 3-16 

CTRL/I, 1-6t 

CTRL/J, 1-6t 

CTRUL, 1-—6t 

CTRL/O, 1-6t, 3-16 

CTRL/Q, 1-6, 1—6t, 3-16 

CTRUR, 1-6t 

CTRL/S, 1-6, 1-6t, 3-16 

CTRL/T, 1-—6t, 4-10 

CtrvU, 1-3 

CTRL/U, 1-6t 

CTRL/X, 1-6t 

CTRL/Z, 1-6t 

DELETE, 1-4, 1-6t 

Down Arrow, 1-18 

ESCAPE, 1-6t 

Fi2, 1-18 

Fi3, 1-18 

Fi4, 1-18 

FORM FEED, 1-6t 

HOLD SCREEN, 1-6t 

Left Arrow, 1-18 

LINE FEED, i—6t, 1-18 

No Scroll, 1-6 

NO SCROLL, 3-16 

RETURN, 1-4, 1-6t 

Right Arrow, 1-18 

RUBOUT, 1-—6t 

TAB, i-6t 

Up Arrow, 1-18 

Keywords 

abbreviating, 2-5 

TODAY, 2-11 

TOMORROW, 2-11 

YESTERDAY, 2-11 


L 


Language qualifiers, 8-32t 
/LAT qualifier 

SHOW/PORT command, 4-12 
Left Arrow key, 1-18. 


/LIBRARY qualifier 


MACRO command, 8-28 
LINE FEED, 1-18 
/LINENUMBERS qualifier 
FORTRAN/FOR command, 8-25 
/LINE_EDITING qualifier 
SET TERMINAL command, 5—5 
LINK command, 8-30 to 846 
qualifiers, 8-30 to 8-46 
/LIST qualifier 
COBOL command, 8—14 
DIBOL command, 8-19 
FORTRAN/F77 command, 8-22 
FORTRAN/FOR command, 8—25 
MACRO command, 8—28 
/LIST_FILE qualifier 
BACKUP command, 3-41 


RESTORE/DIRECTORY command, 3-55 


RESTORE command, 3-49 
/LOADABLE_CHARACTERS qualifier 

SET TERMINAL command, 5-5 
/LOAD_FILL qualifier 

MERGE command, 3-63 

SORT command, 3—57 
/LOCAL_ECHO qualifier 

SET TERMINAL command, 5—5 
Log file 

of terminal session, 5-11 to 5-16 
Logical devices 

see logical names 
Logical names, 6-18 to 6-23 

ASSIGN command, 6—20 

DEASSIGN command, 6—23 

overriding, 6-19 

specifying, 6-18 

systemwide, 6—19 

table of commands, 6—it 

user, 6-19 
Login 

procedure, 1-6 to 1-8 
LOGIN.COM file, 1-9 to 1-10 

system and user, 1—9fg 
LOGIN command, 1-6 
LOGOUT command, 1-12 to 1-13 
Logout procedure, 1-12 to 1-13 
/LOG qualifier 

APPEND command, 3-37 

COPY command, 3-25 

DELETE command, 3-19 

RENAME command, 3-32 

SET FILE command, 3-77 

SET PASSWORD command, 4-17 

SET PROTECTION command, 3-74 

TYPE command, 3-16 
/LOG_DELETE qualifier 

SUBMIT command, 7-7 
/LOG_FILE=file-spec qualifier 

SUBMIT command, 7-7 
/LOG_FILE qualifier 

SET PROMPT command, 4-19 
/LOG_QUEUE=queue-name qualifier 

SUBMIT command, 7—7 
/LOWERCASE qualifier 

SET TERMINAL command, 5—5 
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M 


/MACHINE_CODE qualifier 
FORTRAN/F77 command, 8—22 
FORTRAN/FOR command, 8-25 

MACRO-11 programming, 8-28 

MACRO assembler, 8-3 

MACRO command 
/CROSS_REFERENCE qualifier, 8-28 
/LIBRARY qualifier, 8-28 
/LIST qualifier, 8-28 
/NOLIST qualifier, 8-28 
/NOOBJECT qualifier, 8-28 
/OBJECT qualifier, 8-28 

MACRO commands, 8—28 

Magnetic tape, 6-6 to 6—7 
ANSI and DOS format, 6-6 
density, 6—6 

/MAP qualifier 
COBOL command, 8—14 

/MATCH=size qualifier 
DIFFERENCES command, 3-68 

/MAXIMUM_DIFFERENCES=n qualifier 
DIFFERENCES command, 3-68 

Memory map file sample, 8-46ex 

MERGE command, 3-62 to 3-67 
/ALLOCATION qualifier, 3-63 
/BUCKET_SIZE qualifier, 3-63 
/CHECK_SEQUENCE qualifier, 3—63 
/COLLATING_SEQUENCE qualifier, 3-63 
/CONTIGUOUS qualifier, 3-63 
/DUPLICATES qualifier, 3-63 
/FORMAT qualifier, 3-63 
/INDEXED_SEQUENTIAL qualifier, 3-63 
/KEY qualifier, 3-63 
/LOAD_FILL qualifier, 3-63 
/OVERLAY qualifier, 3-63 
/PROCESS qualifier, 3-63 
/RELATIVE qualifier, 3-63 
/SEQUENTIAL qualifier, 3-63 
/SHAREABLE qualifier, 3-63 
/SPECIFICATION qualifier, 3-63 
/STABLE qualifier, 3-63 
STATISTICS qualifier, 3-63 
/TREE_SPACE qualifier, 3-63 
/WORK_FILES qualifier, 3-63 

/MODE switch, B—10 

/MODIFIED qualifier 
APPEND command, 3-37 
BACKUP command, 3-40 
COPY command, 3-25 
DELETE command, 3-19 
DIRECTORY command, 3-9 
RENAME command, 3-32 
RESTORE/DIRECTORY command, 3-54 
RESTORE command, 3—48 
SET PROTECTION command, 3-74 
TYPE command, 3-16 

MOUNT command, 6—11 
/DENSITY=n qualifier, 6—11 
/FORMAT=ANSI qualifier, 6—11 
/FORMAT=DOS qualifier, 6-11 
/FORMAT=FOREIGN qualifier, 6—11 
/PRIVATE qualifier, 6-11 
/SHARE qualifier, 6-11 
/WRITE qualifier, 6—11 
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Multiline commands 
editing, 1-18 


N 


/NAME<=entry-name qualifier 

PRINT command, 7-3 

SUBMIT command, 7-7 
/NAMES=aa qualifier 

COBOL command, 8-14 
Network 

using, 1-26 to 1-29 
/NOCOMMAND qualifier 

EDIT command, 3—5 
/NOCONTIGUOUS qualifier 

SET FILE command, 3-77 
/NODATE qualifier 

DIRECTORY command, 3-9 
/NODIAGNOSTICS qualifier 

COBOL command, 8—14 
/NOJOURNAL qualifier 

EDIT command, 3—5 
/NOLIST qualifier 

COBOL command, 8—14 

DIBOL command, 8—19 

FORTRAN/F77 command, 8-22 

FORTRAN/FOR command, 8—25 

MACRO command, 8-28 
Nonalphanumeric characters, 2—10t 
/NOOBJECT qualifier 

COBOL command, 8—14 

DIBOL command, 8-19 

FORTRAN/F77 command, 8—22 

FORTRAN/FOR command, 8—25 

MACRO command, 8-28 
/NOOPTIMIZE qualifier 

COBOL command, 8-14 
/NOOUTPUT qualifier 

EDIT command, 3—5 
NORMAL mode, 1-29 
No Scroll key, 1-6 
NO SCROLL key, 3-16 
/NOSIZE qualifier 

DIRECTORY command, 3—9 
/NOSTANDARD=option qualifier 

COBOL command, 8—14 
/NOTIFY qualifier 

PRINT command, 7-3 

SUBMIT command, 7—7 
/NOWARNINGS qualifier 

DIBOL command, 8-19 
/[NOJERROR_LIMIT[=qualifier] qualifier 

CC Command, 8-8 
/[NO]JINCLUDE_DIRECTORY qualifier 

CC Command, 8-8 
/[NO]LIST[=file-spec] qualifier 

CC Command, 8-8 
/[NO]JMACRO[=file-spec] qualifier 

CC Command, 8-8 
/[NOJMEMORY{[=qualifier] qualifie 

CC Command, 8-8 ; 
/[NO]MODULE qualifier 

CC Command, 8-8 
/[NOJOBJECT[=file-spec] qualifier 

CC Command, 8-8 
/[NO]STANDARD[=(option,...)] qualifier 

CC Command, 8-8 


/(NOJTERMINAL[=[NO]SOURCE] qualifier 
CC Command, 8-8 
/[NOJTITLE=(identifier) qualifier 
CC Command, 8-8 
/[NOJUNDEFINE=(identifier[,...]) qualifier 
CC Command, 8-8 
/[NOJ]WARNINGS[=(option,...)] qualifier 
CC Command, 8—8 
/[NOJ]WORK_FILE_SIZE qualifier 
CC Command, 8-8 


O 


Object module, 8-3 
/OBJECT qualifier 
COBOL command, 8-14 
DIBOL command, 8-19 
FORTRAN/F77 command, 8-22 
FORTRAN/FOR command, 8—25 
MACRO command, 8-28 
/OCCURRENCE qualifier 


BACKUP/DIRECTORY command, 3-46 
RESTORE/DIRECTORY command, 3—55 


RESTORE command, 3-49 
ODT mode, 1-29 
OPEN/LOG_FILE command, 5—11 

/APPEND qualifier, 5-12 

/DISABLE qualifier, 5-12 

/ENABLE qualifier, 5-12 

/REPLACE qualifier, 5-12 

/TIME_STAMP qualifier, 5-12 
/OPTIMIZE qualifier 

COBOL command, 8-14 

DIBOL command, 8-19 

FORTRAN/F77 command, 8—22 

FORTRAN/FOR command, 8—25 
/OUTPUT=file-spec qualifier 

DIFFERENCES command, 3-68 

DIRECTORY command, 3-9 

EDIT command, 3-5 
/OUTPUT qualifier 


RESTORE/DIRECTORY command, 3—55 


RESTORE command, 3—50 
SHOW/PORT command, 4-12 
SHOW ACCOUNT command, 4—-14 
SHOW ENTRY command, 7-10 
SHOW JOB command, 4—9 
SHOW QUEUE command, 7-18 
SHOW SYSTEM command, 4—13 
SHOW TERMINAL command, 5-2 
SHOW USER command, 4-8 
/OUT_LABEL 
Interaction During BACKUP, 3—41t 
/OUT_LABEL qualifier 
BACKUP command, 3-41 
RESTORE command, 3-50 
Overlay 
concatenated files, 8-45 
in memory, 8-40fg 
paths, 8-41fg 
/OVERLAY qualifier 
COPY command, 3—25 
MERGE command, 3-63 
SORT command, 3-57 
Overlays, 8-37 to 8-46 
/OVERSTRIKE qualifier 
SET TERMINAL command, 5—5 


/OWNER=ppn qualifier 
PRINT command, 7-3 
SUBMIT command, 7—7 


p 


/PAGE_LIMIT=n qualifier 
PRINT command, 7-3 
SET ENTRY command, 7-14 
Parameters 
abbreviating, 2—6 
/PARAMETERS qualifier 
SUBMIT command, 7-7 
/PARITY qualifier 
SET TERMINAL command, 5—5 
Password 
changing your own, 4—17 
guidelines, 1-2 
PBS 
see Print/Batch Services 
commands, 7—it 
specifying entries, 2-6 
Peripheral devices 
see physical devices 
/PERMANENT qualifier 
SHOW TERMINAL command, 5-2 
Physical devices, 6-1 to 6-18 
ALLOCATE command, 6-8 
DEALLOCATE command, 6—10 
disks, 6-4 to 6-5 
DISMOUNT command, 6—16 
INITIALIZE command, 6—14 
magnetic tape, 6-6 to 6-7 
MOUNT command, 6—11 
names, 6—1, 6—2t 
SHOW command, 6—17 
specifying, 6—1 
/PLACED qualifier 
SET FILE command, 3-77 
/POSITION qualifier 
COPY command, 3-25 
CREATE command, 3-2 
/POSITION switch, B—9 
PPN 
see project-programmer number 
Preallocating files, 3—2 
Print/Batch Services (PBS), 7-1 to 7-19 
DELETE/ENTRY command, 7-17 
entry-number, 7-2 
entry specification, 7—2 
print and batch queues, 7-1 
PRINT command, 7-3 
SET ENTRY command, 7-14 
SHOW ENTRY command, 7-10 
SHOW QUEUE command, 7-18 
SUBMIT command, 7—7 
PRINT command, 7-3 
/AFTER=date:time qualifier, 7-3 
/FORMS=form-name qualifier, 7-3 
/HOLD qualifier, 7-3 
/JOB_COUNT=n qualifier, 7-3 
/NAME=entry-name qualifier, 7-3 
/NOTIFY qualifier, 7-3 
/WRAP qualifier, 7-3 
/PRINTER_PORT qualifier 
SET TERMINAL command, 5—5 


/PRINT qualifier 

DELETE/ENTRY command, 7-17 

SET ENTRY command, 7-14 

SHOW ENTRY command, 7-10 

SHOW QUEUE command, 7-18 
/PRIORITY=n qualifier 

PRINT command, 7-3 

SET ENTRY command, 7-14 
/PRIVATE qualifier 

MOUNT command, 6—11 
Privileges, 1-1 
/PROCESS qualifier 

MERGE command, 3-63 

SORT command, 3-57 
Program development commands, 8—it 
Programming 

BASIC-PLUS, 8-7 

BASIC-PLUS-2, 8-7 

CC, 8-8 

COBOL-81, 8-14 

DIBOL-11, 8-19 

FORTRAN, 8-21 

MACRO-11, 8-28 

RSX based, 8—5 

RT11 based, 8—5 


Programs 
compiling, 8-3 
creating, 8—2 


linking, 8-3, 8-30 to 846 

running, 1-26, 8-47 

testing, 8-4 
Project-programmer number (PPN), 1-2 
$ prompt, 1—7 
Prompt 

changing your text, 4—19 
/PROMPT qualifier 

BACKUP command, 3-42 

REQUEST command, 4—20 

RESTORE/DIRECTORY command, 3—55 

RESTORE command, 3—50 
Prompts 

Dollar sign ($), 1-7 

Ready, 1-8 
Protection 

of files on tape, 6-6 
/PROTECTION=n qualifier 

COPY command, 3-25 

CREATE command, 3-2 

RENAME command, 3-32 

SET FILE command, 3-77 
Protection codes, 1-24, 3-71 to 3—76 

common, 3—73t 

for executable files, 3—72t 

for nonexecutable files, 3—72t 
/PROTECTION qualifier 

DIRECTORY command, 3—9 
/PROTECT switch, B—-7 
Public disk structure, 6—5 


Q 


Qualifiers 
abbreviating, 2-6 
/AFTER, 2-11 
APPEND command, 3-37 
BASIC command, 8—7 
/BEFORE, 2-11 
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Qualifiers (Cont.) 


CC Command, 8-8 
COBOL command, 8-14 
COPY command, 3-25 
CREATE command, 3-2 
defaults, 2-7 
DELETE/ENTRY command, 7-17 
DELETE command, 3-19 
DIBOL command, 8-19 
DIFFERENCES command, 3-68 
DIRECTORY command, 3-9 
entering, 2-7 
entering arguments, 2-8 
FORTRAN/FOR command, 8-25 
INITIALIZE command, 6—16 
LINK command, 8-30 to 846 
MACRO command, 8-28 
MERGE command, 3-63 
MOUNT command, 6—11 
OPEN/LOG_FILE command, 5-12 
RENAME command, 3-32 
SET/LOG_FILE, 5-15 
SET ENTRY command, 7-14 
SET FILE command, 3-77 
SET PROTECTION command, 3-74 
SET TERMINAL command, 5—5 
SHOW ACCOUNT command, 4—14 
SHOW ENTRY command, 7—10 
SHOW JOB command, 4-9 
SHOW QUEUE command, 7-18 
SHOW TERMINAL command, 5-2 
SHOW USER command, 4-8 
/SINCE, 2-11 
SORT command, 3—57 
SUBMIT command, 7—7 
TYPE command, 3—16 
using with DCL commands, 1-13 
with EDIT command, 3-5 
with FORTRAN/F77 command, 8—25 
/QUERY qualifier 
APPEND command, 3-37 
BACKUP command, 3-42 
COPY command, 3-25 
DELETE command, 3-19 
RENAME command, 3-32 
RESTORE command, 3-50 
SET PROTECTION command, 3-74 
TYPE command, 3—16 
Queue, 7-1 
/QUEUE qualifier 
PRINT command, 7-3 
/QUEUE-queue-name qualifier 
SUBMIT command, 7—7 
Quota 
disk, 1-6, 1-25 


R 


Ready prompt, 1—8 
/READ_ONLY qualifier 
EDIT command, 3—5 
RECALL command, 1-16 
/ALL qualifier, 1-16 
/ERASE qualifier, 1-16 
/RECALL qualifier 
SET TERMINAL command, 5—5 


/RECOVER qualifier 


EDIT command, 3-5 
/REGIS qualifier 
SET TERMINAL command, 5-5 
/RELATIVE qualifier 
MERGE command, 3-63 
SORT command, 3-57 
/RELEASE qualifier 
SET ENTRY command, 7—14 
RENAME command, 3-32 to 3-35 
/BEFORE=date qualifier, 3-32 
/CONEFIRM qualifier, 3-32 
/CREATED qualifier, 3-32 
/LOG qualifier, 3-32 
/MODIFIED qualifier, 3-32 
/PROTECTIONEn qualifier, 3-32 
/QUERY qualifier, 3-32 
/REPLACE qualifier, 3-32 
/SELECT=SIZE qualifier, 3-32 
/SINCE=date qualifier, 3-32 
/WARNINGS qualifier, 3-32 
/REPLACE qualifier 
COPY command, 3-25 
CREATE command, 3—2 


OPEN/LOG_FILE command, 5-12 


RENAME command, 3-32 
RESTORE command, 3-50 
/REPLY qualifier 
REQUEST command, 4-20 
REQUEST command, 4—20 
/PROMPT qualifier, 4—20 
/REPLY qualifier, 4—20 
/TIME_OUT qualifier, 4—20 
/RESET qualifier 
SET TERMINAL command, 5—5 
RESTORE/DIRECTORY command 
/BRIEF qualifier, 3-54 
/CREATED qualifier, 3-54 
/END qualifier, 3-54 
/EXCLUDE qualifier, 3-54 
/FULL qualifier, 3-55 
/INCLUDE qualifier, 3-55 
/IN_LABEL qualifier, 3-55 
/LIST_FILE qualifier, 3-55 
/MODIFIED qualifier, 3-54 
/OCCURRENCE qualifier, 3-55 
/OUTPUT qualifier, 3-55 
/PROMPT qualifier, 3-55 
/REWIND qualifier, 3-55 
/SELECT qualifier, 3-55 
RESTORE command, 3—52 
/CREATED qualifier, 3-48 
/END qualifier, 3-49 
/EXCLUDE qualifier, 3-49 
/FILE_DATA qualifier, 3-49 
/INCLUDE qualifier, 3-49 
/INITIALIZE qualifier, 3-49 
/IN_LABEL qualifier, 3-49 
/MODIFIED qualifier, 3-48 
/OCCURRENCE qualifier, 3-49 
/OUTPUT qualifier, 3-50 
/OUT_LABEL qualifier, 3-50 
/PROMPT qualifier, 3-50 
/QUERY qualifier, 3-50 
/REPLACE qualifier, 3-50 
restrictions, 3-47 
/REWIND qualifier, 3-51 


RESTORE command (Cont.) 


/SELECT qualifier, 3-51 
/VERIFY qualifier, 3-51 
Restrictions 
RESTORE command, 3-47 
/RETAIN_DATES qualifier 
COPY command, 3-25 
RETURN key, 1-4 
/REWIND qualifier 
BACKUP command, 3—42 
RESTORE/DIRECTORY command, 3-55 
RESTORE command, 3—51 
Right Arrow key, 1-18 
/RONLY switch, B—10 
RSX 
command environment, 1-8 
commands, B—6t 
RSX-based programming, 8—5 
RT11 
command environment, 1-8 
commands, B—3t 
RT11 and RSX program development commands, 
8—5t 
RT11-based programming, 8-5 
RUBOUT key 


see DELETE key 
RUN command, 8—47 
Running a program, 1-26 
/RUNTIME_SYSTEM=name qualifier 
SET FILE command, 3—77 


S 


/SCOPE qualifier 
SET TERMINAL command, 5—5 
/SELECT=SIZE qualifier 
APPEND command, 3-37 
COPY command, 3-25 
DELETE command, 3-19 
DIRECTORY command, 3—9 
RENAME command, 3-32 
SET PROTECTION command, 3-74 
TYPE command, 3-16 
/SELECT qualifier 
RESTORE/DIRECTORY command, 3-55 
RESTORE command, 3-51 
/SELECT_ERASE qualifier 
SET TERMINAL command, 5—5 
/SEQUENTIAL qualifier 
MERGE command, 3-63 
SORT command, 3—57 
SET/LOG_FILE command, 5-15 
/DISABLE qualifier, 5-15 
/ENABLE qualifier, 5-15 
/TIME_STAMP qualifier, 5-15 
SET command, 4-16 to 4—19 
ENTRY, 7-14 
HOST, 1-28 
options, 4—16t 
PASSWORD, 4-17 
PROMPT, 4-19 
TERMINAL, 5-4 to 5-10 
SET CONTROL=C command, 4—16t 
SET DATA command, 4—16t 
SET ECHO command, 4—16t 
SET ENTRY command, 4—16t, 7-14 
/AFTER=date:time qualifier, 7-14 
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SET ENTRY command (Cont.) 
/ALL qualifier, 7-14 
/BATCH qualifier, 7-14 
/CPU_LIMIT=n qualifier, 7-14 
/FORMS=form-name qualifier, 7-14 
/HOLD qualifier, 7-14 
/JOB_COUNT=n qualifier, 7-14 
/PAGE_LIMIT=n qualifier, 7-14 
/PRIORITY=n qualifier, 7-14 
/RELEASE qualifier, 7-14 
/TIME_LIMIT=n qualifier, 7-14 

SET FILE command, 3-77, 4—16t 
/BACKUP qualifier, 3—77 
/CACHE qualifier, 3-77 
/DELETABLE qualifier, 3-77 
/IGNORE qualifier, 3-77 
/LOG qualifier, 3-77 
/NOCONTIGUOUS qualifier, 3-77 
/PLACED qualifier, 3-77 
/PROTECTION=n qualifier, 3-77 
/RUNTIME_SYSTEM=name qualifier, 3-77 

SET HOST, 1-29 
NORMAL mode, 1-29 
ODT mode, 1-29 

SET HOST command, 4—16t 

SET LOG_FILE command, 4—16t 

SET ON command, 4—16t 

SET PASSWORD command, 4—16t, 4-17 
/LOG qualifier, 4-17 

SET PROMPT commana, 4-19 
/LOG_FILE qualifier, 4-19 

SET PROTECTION command, 4—-16t 
/BEFORE=date qualifier, 3—74 
/CONFIRM qualifier, 3-74 
/DEFAULT qualifier, 3-74 
/LOG qualifier, 3-74 
/MODIFIED qualifier, 3-74 
/QUERY qualifier, 3-74 
/SELECT=SIZE qualifier, 3-74 
/SINCE=date qualifier, 3-74 

SET TERMINAL command, 4—-16t, 5-4 to 5-10 
/ADVANCED_VIDEO qualifier, 5-5 
/ALT_MODE qualifier, 5-5 
/ANSI qualifier, 5—5 
/BREAK qualifier, 5-5 
/BROADCAST qualifier, 5—5 
/132_COLUMNS qualifier, 5-5 
/CONTROL qualifier, 5-5 
/CRFILL qualifier, 5—5 
/DELIMITER qualifier, 5-5 
/DEVICE_TYPE qualifier, 5—5 
/EIGHT_BIT qualifier, 5—5 
/ESCAPE_SEQUENCE qualifier, 5-5 
/FORM_FEED qualifier, 5-5 
/HARDCOPY qualifier, 5-5 
/HOST_SYNC qualifier, 5-5 
/INQUIRE qualifier, 5—5 
/INSERT qualifier, 5-5 
/KATAKANA qualifier, 5—5 
/LINE_EDITING qualifier, 5—5 
/LOADABLE_CHARACTERS qualifier, 5—5 
/LOCAL_ECHO qualifier, 5—5 
/LOWERCASE qualifier, 5—5 
/OVERSTRIKE qualifier, 5—5 
/PRINTER_PORT qualifier, 5-5 
/RECALL qualifier, 5—5 
/REGIS qualifier, 5-5 


Index—12 


SET TERMINAL command (Cont.) 


/RESET qualifier, 5—5 
/RESUME qualifier, 5-5 
/SCOPE qualifier, 5—5 
/SELECT_ERASE qualifier, 5—5 
/SETUP=file-name qualifier, 5-5 
/SIXEL qualifier, 5-5 
/SPEED qualifier, 5—5 
/TAB qualifier, 5-5 
/TTSYNC qualifier, 5-5 
/TYPE=n qualifier, 5—5 
/UPPERCASE qualifier, 5—5 
/UP_ARROW qualifier, 5-5 
/USER_DEFINED_KEYS qualifier, 5-5 
/WIDTH=n qualifier, 5—5 
/SETUP=file-name qualifier 
SET TERMINAL command, 5—5 
SET VERIFY command, 4—16t 
/SHAREABLE qualifier 
MERGE command, 3-63 
SORT command, 3—57 
/SHARE qualifier 
MOUNT command, 6—11 
SHOW/PORT command 
/ALL qualifier, 4-12 
/APPLICATION qualifier, 4-12 
ANTERACTIVE qualifier, 4-12 
/LAT qualifier, 4-12 
/OUTPUT qualifier, 4-12 
/SHOW=MAP qualifier 
COBOL command, 8—14 
SHOW ACCOUNT command, 4—it, 4-14 
/ACCOUNTING_DATA qualifier, 4-14 
/BRIEF qualifier, 4-14 
/FULL qualifier, 4-14 
/OUTPUT qualifier, 4-14 
SHOW BUFFERS command, 4-it 
SHOW CACHE command, 4-it 
SHOW command, 4-1 to 4—15 
ACCOUNT, 4-14 
DEVICE, 6-17 
DEVICE/ALLOCATED, 6-17 
DISKS, 6—17 
ENTRY, 7-10 
JOB, 4-9 
NETWORK, 1-28 
options, 4—1t 
PORT, 4-11 
QUEUE, 7-18 
SYSTEM, 4-13 
TERMINAL, 5-2 
USER, 4-8 
SHOW COUNTERS/LAT command, 4—1t 
SHOW DATE command, 4—1t 
SHOW DAYTIME command, 4—it 
SHOW DEVICE/ALLOCATED 
abbreviations, 6—17t 
SHOW DEVICE/ALLOCATED command, 4—1t, 6-17 
SHOW DEVICE command, 4—it, 6-17 
SHOW DISKS 
abbreviations, 6—17t 
SHOW DISKS command, 4—1t, 6-17 
SHOW ENTRY command, 4—1t, 7-10 
/ALL qualifier, 7-10 
/BATCH qualifier, 7—10 
/BRIEF qualifier, 7-10 
/FILES qualifier, 7-10 


SHOW ENTRY command (Cont.) 
/FULL qualifier, 7—10 
/OUTPUT qualifier, 7-10 
/PRINT qualifier, 7-10 
/STATUS qualifier, 7-10 
SHOW FILE command, 4—it 
SHOW JOB/PRIVILEGES command, 4—it 
SHOW JOB command, 4—it, 4-9 
abbreviations, 4—4t 
/ALL qualifier, 4-9 
/ATTACHED qualifier, 4—9 
/DETACHED qualifier, 4—9 
/OUTPUT qualifier, 4—9 
/TERMINAL=KBn: qualifier, 4—9 
SHOW LIBRARY command, 4—(t 
SHOWLOGICALS command, 4—it 
SHOW MEMORY command, 4—1t 
SHOW NETWORK command, 4—1t 
SHOW NODE/LAT command, 4—it 
SHOW OPERATOR_SERVICES command, 4—it 
SHOW PORT command, 4—1t, 4—11 
SHOW PRINTER command, 4—1t 
/SHOW qualifier 
COBOL command, 814 
SHOW QUEUE command, 4—It, 7-18 
/ALL qualifier, 7-18 
/BATCH qualifier, 7-18 
/BRIEF qualifier, 7-18 
/FULL qualifier, 7-18 
/OUTPUT qualifier, 7-18 
/PRINT qualifier, 7-18 
SHOW RECEIVERS command, 4—it 
SHOW RUNTIME_SYSTEMS command, 4—it 
SHOW SERVER command, 4—it 
SHOW SERVICES/LAT command, 4—it 
SHOW SESSIONS command, 4—1t 
SHOW SYMBOL command, 4—it 
SHOW SYSTEM command, 4-1t, 4-13 
/EMT_LOGGINGS qualifier, 4—13 
/OUTPUT qualifier, 4-13 
SHOW TERMINAL command, 4—1t, 5-2 
/ALL qualifier, 5—2 
/BRIEF qualifier, 5-2 
/FULL qualifier, 5-2 
/OUTPUT qualifier, 5-2 
/PERMANENT qualifier, 5-2 
SHOW TERMINAL_SERVERS/LAT command, 4—1t 
SHOW TIME command, 4—it 
SHOW USER command, 4—-it, 4-8 
abbreviations, 4—4t 
/ALL qualifier, 4-8 
/ATTACHED qualifier, 4-8 
/DETACHED qualifier, 4—8 
/OUTPUT qualifier, 4—8 
/TERMINAL=KBn: qualifier, 4-8 
/SHOW[=option,...] qualifier 
CC Command, 8-8 
/SINCE=date qualifier 
APPEND command, 3-37 
COPY command, 3-25 | 
DELETE command, 3—19 
DIRECTORY command, 3-9 
RENAME command, 3-32 
SET PROTECTION command, 3—74 
TYPE command, 3-16 
/SINCE qualifier, 2-11 


/SIXEL qualifier 


SET TERMINAL command, 5—5 
/SIZE qualifier 
DIRECTORY command, 3—9 
SORT command, 3—56 to 3-61 
/ALLOCATION qualifier, 3-57 
/BUCKET_SIZE qualifier, 3-57 
/COLLATING_SEQUENCE qualifier, 3-57 
/CONTIGUOUS qualifier, 3-57 
/DUPLICATES qualifier, 3-57 
/FORMAT qualifier, 3-57 
/ANDEXED_SEQUENTIAL qualifier, 3-57 
/KEY qualifier, 3-57 
/LOAD_FILL qualifier, 3-57 
/OVERLAY qualifier, 3-57 
/PROCESS qualifier, 3-57 
/RELATIVE qualifier, 3-57 
/SEQUENTIAL qualifier, 3-57 
/SHAREABLE qualifier, 3-57 
/SPECIFICATION qualifier, 3-57 
/STABLE qualifier, 3-57 
/STATISTICS qualifier, 3-57 
/TREE_SPACE qualifier, 3-57 
/WORK_FILES qualifier, 3-57 
/SPECIFICATION qualifier 
MERGE command, 3—63 
SORT command, 3—57 
/SPEED qualifier 
SET TERMINAL command, 5—5 
/STABLE qualifier 
MERGE command, 3-63 
SORT command, 3—57 
/STANDARD<=option qualifier 
COBOL command, 8—14 
/STANDARD qualifier 
DIBOL command, 8-19 
FORTRAN/F77 command, 8-22 
/STATISTICS qualifier 
MERGE command, 3-63 
SORT command, 3—57 
/STATUS qualifier 
SHOW ENTRY command, 7-10 
SUBMIT command, 7-7 
/AFTER=date:time qualifier, 7—7 
/CPU_LIMIT=n qualifier, 7-7 
/DELETE qualifier, 7-7 
/HOLD qualifier, 7—7 
/LOG_DELETE qualifier, 7-7 
/LOG_FILE=file-spec qualifier, 7—7 
/LOG_QUEUE=queue-name qualifier, 7—7 
/NAME=entry-name qualifier, 7-7 
/NOTIFY qualifier, 7—7 
/OWNER=ppn qualifier, 7-7 
/PARAMETERS=(parameter,...) qualifier, 7—7 
/PRIORITY=n qualifier, 7—7 
/QUEUE=queue-name qualifier, 7—7 
/TIME_LIMIT=n qualifier, 7—7 
System disk, 6-4 
System status display, 4-4, 4—-4t 
Systemwide logical names, 6—19 


+ 


‘TAB qualifier 

SET TERMINAL command, 5—5 
Tape density, 6-6 
Task Builder, 8-31 
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/TEMPORARY=device qualifier 

COBOL command, 8-14 
/TERMINAL=KBn: qualifier 

SHOW JOB command, 4-9 

SHOW USER command, 4-8 
Terminal characteristics 

displaying, 5—1, 5-2 

setting, 5-1, 5-4 to 5-10 
Terminal logging, 5—11 to 5-16 

CLOSE/LOG_FILE, 5-14 

OPEN/LOG_FILE, 5-11 

SET/LOG_FILE, 5-15 
Times 

format for entering, 2-11 
_/TIME_LIMIT=n qualifier 

SET ENTRY command, 7-14 

SUBMIT command, 7-7 
/TIME_OUT qualifier 

REQUEST command, 4-20 
/TIME_STAMP qualifier 

OPEN/LOG_FILE command, 5—12 

SET/LOG_FILE command, 5-15 
TODAY keyword, 2-11 
TOMORROW keyword, 2-11 
/TOTAL qualifier 

DIRECTORY command, 3-9 
/TREE_SPACE qualifier 

MERGE command, 3-63 

SORT command, 3—57 
/TRUNCATE qualifier 

COBOL command, 8—14 

PRINT command, 7-3 
/TTSYNC qualifier 

SET TERMINAL command, 5—5 
/TYPE=n qualifier 

SET TERMINAL command, 5—5 
Typeahead, 1-9 
TYPE command, 3-16 to 3-18 

/BEFORE=date qualifier, 3-16 

/CONFIRM qualifier, 3-16 

/CREATED qualifier, 3-16 

/LOG qualifier, 3-16 

/MODIFIED qualifier, 3-16 

/QUERY qualifier, 3-16 

/SELECT=SIZE qualifier, 3-16 

/SINCE=date qualifier, 3-16 


U 


Underscore character 


to override name precedence, 6—19 


Up Arrow, 1-18 
/UPPERCASE qualifier 
SET TERMINAL command, 5—5 
/UP_ARROW qualifier 
SET TERMINAL command, 5—5 
User logical names, 6-19 
/USER_DEFINED_KEYS qualifier 
SET TERMINAL command, 5—5 


V 


/VERIFY qualifier 
BACKUP command, 3-43 
RESTORE command, 3-51 
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W 


/WARNINGS qualifier 
COBOL command, 8-14 
DELETE command, 3-19 
DIBOL command, 8-19 
FORTRAN/F77 command, 8-22 
FORTRAN/FOR command, 8-25 
RENAME command, 3-32 
/WIDTH=n qualifier 
SET TERMINAL command, 5-5 
Wildcards, 1-25 
/WORK_FILES=n qualifier 
FORTRAN/F77 command, 8-22 
/WORK_FILES qualifier 
MERGE command, 3—63 
SORT command, 3—57 
/WRAP qualifier 
PRINT command, 7—3 
/WRITE qualifier 
MOUNT command, 6-11 


Y 


YESTERDAY keyword, 2-11 


How to Order Additional Documentation 


Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 


your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location 
Continental USA, 


Alaska, or Hawaii 


Puerto Rico 


Canada 


International 


Internal! 


Call 
800-DIGITAL 


809-754-7575 
800-267-6215 


Contact 


Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


Local Digital subsidiary 


Digital Equipment of Canada 

Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 


Local Digital subsidiary or 
approved distributor 


USASSB Order Processing - WMO/E15 
or 

U.S. Area Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


1For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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